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WHEN I WAN T ADVICE 
PROGRAMMING, I 


ABOUT OBJECT-ORIENTED 
’LL ASK AN EXPERT. 



SO, ASK US. 


You already know reusable class libraries promise a 
dramatic increase in productivity and efficiency for 
professional application developers. You also know class 
libraries created with one C++ compiler can't link with code 
created by another C++ compiler. And that libraries written 
in one language can't be used with client code written in 
another language. 

But here's something you might not know: MetaWare and 
IBM are changing all that. 

Out With The Old. In With The New. The tight binary 
coupling that exists between object-oriented class libraries 
and client code means that changes to either—no matter 
how small—require a complete recompilation not only of 
the class itself, but of all the client modules 
as well. 

But with IB M's System Object Model (SOM) 
and MetaWare's High C/C++ DirectToSOM 
compiler for OS/2, developers can break that 
tight binary coupling and extend the 
advantages of procedure libraries to 
object-oriented technology. 


Pretty amazing, right? And right now, you think this is where 
our pitch to sell you a compiler comes in. But you're wrong. 

Information Only. And lt T s Free. We know what you 
really want is information. That way you can make up your 
own mind about the benefits of SOM and the DirectToSOM 
High C/C++ compiler for OS/2, We've prepared a white 
paper that will help. It's called Truly Reusable Objects 
Directly From C++: How to Create and Distribute Them. It’s 
yours just for the asking. 

To receive your free information, call, fax, or e-mail 
MetaWare at the numbers shown below. Once you review 
the facts for yourself, you'll understand why MetaWare and 
IBM mean "objects made easy," 



CALL 408 429 6382 
FAX 408 429 9273 
OR 

E-MAIL TECKSALES@METAWARE.COM 
FOR YOUR FREE COPY, 

TODAY. 


“to 


MetaWare 

OBJECTS MADE EASY 
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Visual SlickEdit 
for OS/2— 
the intelligent 
programmer's editor 

byMicroEdge, Inc , 

This high-powered programmer s 
ediior is completely customizable 
with the speed to ignite your pro¬ 
ductivity. Save time using BRIEF, 

Emacs, or VI emulations. Take 
off with Visual SlickEdit's GUI interface, built-in dialog editor, 
and C-siyle macro language. Features include; SmartPaste"; 
compiler error processing; syntax color-coding; expansion and 
indenting: and an on-line manual. 30 day risk-free trial! 

Discount Price: *219* • Offer ends October 31 1 1995, 

Paradise No. MEVSE3100-BE 



PBED1TOR/2 

by CompuWare Corp. 
PRED1TQR/2 is a graphical 
32-bit source code ediior for 
the demanding programmer. 
PREDITQR/2 is for programmers 
who dan*t have the time to 
deal with rigid programming 
environments, who must change 
capabilities to fit their exact 
requirements, and who need 
to dramatically extend editing functions to attain peak 
productivity. FREDITGR/2 knows no boundaries on file size, 
line length, buffers, windows, undo/redo, etc. 

Discount Price: *149 
Paradise No. CWPD23100-BE 



c-tree Plus 0 * 

by FairCom Corporation 
DOS - WINDOWS - NT - UNIX - 
OS/2 * SUN * RS6DG0 * HP90D0 - 
MAC - QNX - BANYAN * SCO. 

This well known, highly portable data 
management package has become 
established as the tool of choice for 
commercial development. Offering 
unprecedented data control, choose 
from direct low level access, ISAM 
level, or SQL access with the FairCom Server. Single User, 
Multi User, or optional Client/Server, ANSI Standard. Full 
Source. No Royalties. 

Discount Price: *519 
Paradise No, FACT+3100-BE 
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FAIRCOM* 

since 197S 


IBM® VisualAge" C++ 

I Version 3.0 

^ by IBM 

IBM VisualAge C++ V3.0 combines 
the productivity-boosting visual 
programming capability of IBM 
JJtfT ^ VisualAge with robust, professional 

development tools from the popular 
IBM C 561++™ product. This powerful 
combo lets you visually build pans then assemble them into 
mission-critical, object-oriented programs. 

CD & On-Line Docs Discount Price: *399 

Paradise No. IB3GHI666-BE 


Competitive Upgrade 
Paradise No. IB30H1776-BE 


Discount Price: *289 



KopyKat 
Remote Control 

by Hilgraeve 

Anything you can run on a PC with 
OS/2 you can now do remotely via 
LAN, Modems, or Serial Cable. You 
can run: ihe remote computer's entire 
OS/2 desktop; presentation manager 
programs—both 16- and 32-bit; com¬ 
mand sessions or text mode,,.win¬ 
dowed or full screen; Microsoft 
Windows 'seamless" or full screen; and DOS sessions or pro¬ 
grams, windowed or full screen. Runs on Novell &. IBM LANs. 

Discount Price: *125 
Paradise No HGKKG3100-BE 


Watcm 

VX'REXX 

OKBL’SmeMfa 
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Watcom VX*Rex> 
Client/Server 2.1 

by Watcom International 
A visual development environment 
for OS/2. Powerful connection, query 
and chart objects allow you to access 
several databases, manipulate data 
and chart the results quickly and 
easily. Features include; drag-and- 
drop programming; bound controls; 
and professional multi-threaded, 
multi-windowed and drag-and-drop 
emibled application development 


Paradise No. Discount Price 
Borland C++2.0 for OS/2 


Discount Price: *281 
Paradise No. WATVC3IG0-BE 



DataTable 
for OS/2 

by ProtoView 
Development Corp , 

DataTable is a sophisticated 
spreadsheet control. Through 
a robust message-based API 
and numerous notification codes, developers can control every 
aspect of their application. Features include; virtual memory 
management; column sorting; column locking; check boxes and 
combo boxes; and colors and fonts may be set on a cell, row- 
column or table basts. New for OS/2, vertical window splitting. 

Discount Price: 5 476 
Paradise No, PDDT03100-BE 


BOCGT88S8-BE ... 

. s 339 

EZRAID PRO 
PEEP03100-RE ... 

.*764 

GainmaTech Utilities 
STGT03100-RE. 

*99 

IBM Smalltalk 2,0 
IBM14H0270-BE 

. . .*699 

IBM VisualAge 2.0 

IBM I?M7495-BE .. 
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Mesa/2* 

ADS20310G-BE ........... 

.,,,*189 

MKS Source Integrity for OS/2 
MKS103100-BE .. s 360 

OnCmd Xbase for OS/2 
OLDCX3100-RE .. 

. s 240 

Opt Tech Sort 
OPOTSOIOO-BE.. 

.*240 

Prominarc Designer 
PRDGO3K)0:BE . 

. s 640 


Watcom C/C++ VI0,5 Competitive Upg, 
call for more information. ,.. s 189 



SPF/PC Version 4.0 

by Command 
Technologies Corp, 

Provides a familiar environment 
on the PC for ISPF/PDF main¬ 
frame programmers, Includes: 

Modifiable Panels & Table 
Services; UNDO/REDO; Program 
Source Colorization; SUPERC file comparison; vertical splits; 
mouse support; 64,000 max record length; 132-column support; 
and 20+ new primary commands. SPF/PC features: full 3270 
compatibility; 1SRED1T macros via REXX; ASCH/EBCDIC 
file editing; COBOL workbench integration; CUT/PASTE; 
fully mappable keyboard; and keyboard macros. 

Discount Price; *199 
Paradise No, CTSP43IOO-BE 



Phone order 

SOO 445 7899 

FAX order 

908 389 9227 

International Sales 

908 389 9229 
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Shrewsbury, NJ 077QR-4321 


Call for shipping 
Ohargas/ratum policies 
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In the Race for Solutions, 

Finish First 



Introducing VisPro/Reports, the first programmable 
report writer for VisPro/REXX, VX REXX and OS/2 REXX 


On April 28,1993 HockWare Inc. shipped 
VisPro/REXX, the first OS/2 visual programming 
tool for REXX. Since then, we’ve achieved many 
other firsts. VisPro/REXX, VisPro/C and 
VisPra/C++ are the first REXX, C and C++ tools 
to incorporate drag and drop programming, an 
entity-relationship database designer, and a rich 
set of add-on objects including: spreadsheet, 
business graphics, formatted entry field, clock 
and calendar. Whether you’re using REXX, 
C-Presentation Manager, or IBM’s User-Interface 
Gass Library; there is a VisPro product to meet 
your needs. 


• Banded report options allow you to choose 
from a rich set of headers, footers and groups. 

• Label reports allow r you to select from a large 
list of Avery labels. 

• Support for multiple line text, derived fields, 
business graphics, bitmap images, rectangles, 
lines and ellipses. 

• Many object properties to choose from, 
including any OS/2 font, 16 million colors, line 
styles, fill patterns and drop shadows. 

• Wide selection of field options, International 
currency and formulas. 

• Numerous sample reports included. 


Yet Another First 

VisPro/Reports is the latest addition to 
the VisPro family of OS/2 
programming products. 

VisPro users will recognize 
the easy-to-use CUA’91 
user-interface and the drag 
drop style HockWare pioneered 
years ago. 

Designing Reports is Easy 

• WYSIWYG, free-format report design tool. 


Report Printing is Easy 

• Seamlessly print or preview reports 





from any OS/2 REXX environ¬ 
ment including VisPro/REXX, 
VX REXX and plain OS/2 REXX. 
• Use your favorite REXX- 
enabled databases and third 
party libraries for access to DB2, 
.DBF files, EHLLAPI mainframe 
connections and more. 

> A runtime DLL of less than 100K 
can be distributed royalty free. 


The Complete VisPro Family 

VlsPra/Reports . $199 

VisPro/REXX Gold.$299 

VisPro/REXX Bronze. ££9 $ 59 

VisPro/REXX Data Entry Object Pack .. $Jf9 $ 89 
VisPro/C or VisPro/C++ SPECIAL!!! $>99 $199 

VisPro Development Suite. $>99 $499 

(includes VisPro/REXX Gold, C and C++) 


Whether you’ve already discovered the VisPro 
family of visual programming products or you’re 
just getting to know us, meet 
our latest member, 

VisPro/Reports. And be 
the first to get where 1 
you’re going. 4 
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Hock ... 
Ware 

Pulling You in (unlrol 


HockWare Incorporated 

P.O. Box 336 

Cary. NC 27512-0336 

919-380-0616 

919-380-0757 FAX 

Go HockWare on CompuServe 

hockware@vnet.net on Internet 

http://www.nando.net/ads/hockware 


HockWare, VlsPro/C, V!sPro/C++. VisPro/REXX and VisPnVRepons are trademarks of HockW are Incorporated. All other company, product and brand names are trademarks and/or registered trademarks of their 
respective holders and are mentioned for reference purposes only. 01995 HockWare Incorporated. All rights reserved. 
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RimStar was the first native OS/2 PM editor In fact, it and jump to errors, hex editing, and source code 
was the first GUI editor of its kind. So what's new? browser for 'C'.,.. 


Introducing RimStar's 
30-Day Free Trial offer. Right 
now, free of charge, you can 
use the leading OS/2 editor 
for 30 days — fully functional 
with our syntax coloring, 
complete ANSI 'C' macro 
language, smart C/C++ 
indenting and template 
expansion, no limits on line 
length, file size, number of 
files or windows, compile 


"My copy of Brief has been permanently retired! 

Keep up the good work^AA. 

For a limited time, RimStar is yours - free - to use for 30 days. 


But why talk about features 
when you can try out the lead¬ 
ing OS/2 editor for yourself - 
free? Call now for your copy: 

1 -800-746-7007 Outside the 
US, call 603-778-2500 or fax 
your order: 603-778-2408. 

If you like it, you can 
have the RimStar Programmer's 
Editor for OS/2 or Windows, 
Windows 95 and Windows NT 
for only $199. 


L| GHTING THE WAV 

Designed by programmers for programmers 
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BY DICK CONKLIN 


Power(PC) 
to the People 


W e've followed with interest IBM’s quest 
for a portable, microkernel-based soft¬ 
ware strategy, The concept of Work¬ 
place OS has been around for two years now, but 
we haven't had a real life example—until now. 
Almost everyone agrees that this is the right way 
to go: an operating system personality built on a 
microkernel built on a hardware base, A radical¬ 
ly new hardware base, such as the RISC-powered 
PowerPC, meant a new version of OS/2 was nec¬ 
essary, But how much work would it take to 
make existing applications run? Would Work¬ 
place OS preserve the OS/2 API as it had 
promised? Would this pave the way for some 
super-performing multimedia applications? 

Well, the wait is over. IBM produced the oper¬ 
ating system, first called OS/2, for PowerPC and, 
later, officially named OS/2 Warp Connect 
(PowerPC Edition). Met a Ware delivered a 
C/C++ compiler. The main requirement was that 
your OS/2 application had to be a 32-bit pro¬ 
gram. Then, you simply ported over to PowerPC 
and ...? 

But let's let some of our pioneering developers 
finish the story. We asked three of IBM's Power¬ 


PC beta users to tell us 
about their migration from 
OS/2 Warp to the PowerPC 
Edition—Sundial Systems, 
AdeptSoft, and Pinnacle 
Technology, Are you ready 
for PowerPC? Judge for 
yourself. 
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OS/2 Toolbox 


In this issue, our OS/2 Toolbox column reviews MicroEdge's Visual SlickEdit for OS/2. 

ByGUYSCHARF 


Visual SlickEdit 
for OS/2 



Guy Scharf 


M icroEdge's Visual SlickEdit for 
OS/2, version 1.72, is a power¬ 
ful, graphical, programmer's 
editor for OS/2. The editor is extremely flex¬ 
ible, allowing you to easily tailor it to your 
own style. Language support is extensive; a 
version control interface is built in; color 
syntax highlighting is included; and a $lkk- 
C programming language allows you to 
modify and extend the editor as needed. 
Smart syntax expansion writes some of your 
code for you. There's even a spell checker! 

Visual SlickEdit offers a broad range of 
cross-platform support than most other edi¬ 
tors, MicroEdge has versions of Visual 
SlickEdit for Windows 3,1, NT, and 95 as 
well, A related product, the character-mode 
SlickEdit editor, is available for DOS and 
more than 15 flavors of Unix. 

Visual SlickEdit is supplied on three 
diskettes, and installation is straightforward. 
A complete installation takes 6.8 megabytes 
on your hard disk; a minimum installation 
requires 4 megabytes. A 25-MHz 486 is rec¬ 
ommended as the minimum system. 1 tested 
Visual SlickEdit for OS/2 on a 50-MHz 486 
with 32 megabytes of memory and found 
performance quite acceptable. 


CONFIGURING VISUAL SLICKEDIT 

When you install Visual SlickEdit, you select 
the keyboard emulation that you prefer to 
use, CUA, Brief, Emacs, SlickEdit, and vi are 
supported. You can change your selection 
later using the Configuration dialog (see 
Figure 1). The keyboard emulation is imple¬ 
mented as bindings between keys and inter¬ 
nal functions. You can easily alter these 
bindings to produce any keyboard you want. 
Ail of the keystroke combinations that I refer 
to here are for the CUA keyboard emulation 
style; other emulations may use different 
keystrokes. The manual and online help de¬ 


scribe the keystrokes for each keyboard emu¬ 
lation. You can also ask Visual SlickEdit to 
create a file with the active definitions. 

Figure 2 shows the main editing screen. 
You can configure the menu, button bar, 
scroll bars, and more using the Con¬ 
figuration dialog. An unusual feature is that 
you can alter Visual SlickEdit's own dialogs. 
The Slick-C programming language includes 
dialog support. Since Visual SlickEdit's own 
dialogs are created using the same tool, you 
can modify them to obtain the appearance 
you want. 

Using the File Extension configuration 
option, you can tailor the Visual SlickEdit's 
behavior based on the file extension. Figure 3 
shows how I have defined the behavior for C 
hies; for example, tabs are at intervals of four 
columns. Using other dialogs, you can select 
which programming style variation you want 
for syntax expansion, such as where the 
braces should be located after an if statement. 

The dialogs shown only touch the sur¬ 
face of the ability to configure Visual Slick¬ 
Edit. In my testing, 1 found minor features 
that did not operate the way 1 wanted them 
to. In all cases, I was able to change the con¬ 
figuration so that I got the behavior that I 
wanted. Finding the right way to request the 
change was not always obvious, but 
MicroEdge technical support was able to 
direct me to the solution quickly. 

EASE OF USE 

Visual SlickEdit is easy to use, with lots of 
tools to help the programmer. For safety, 
backups are made when a file is saved and 
optionally on a timed basis as well. 

The editing functions are powerful. 
Line, block, and character selection are all 
available. The new SmartPaste function is 
especially nice: paste code into an existing 
function and it is automatically indented cor- 
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rectly for the location you are pasting it into. 
When you need word processing, automatic 
word-wrap, margins, and justification are 
available. Undo and redo is supported for up 
to 32,000 events. While that's not unlimited, 
that's more than I ever edit in one session. 

Color syntax highlighting dearly sepa¬ 
rates comments from code and immediately 
shows any errors in closing a comment or 
string. Syntax expansion and indenting work 
well. Type if followed by a space and Visual 
SlickEdit inserts: 

if () 

{ 

} 

in your program* 

Support is provided for C, C++, Pascal, 
Fortran, Basic, dBASE, Modula-2, Assembly, 
COBOL, and Ada. The manual describes 
how you can add support for other lan¬ 
guages as well 

Visual SlickEdit allows you to group 
files together in projects. In a project configu¬ 
ration dialog, you define what files are part 
of the project. For each project, you can 
define the make command for the project, or 
the commands to compile individual mod¬ 
ules, in a project configuration dialog shown 
in Figure 4. With the project defined, Ctrl+M 
compiles the project. 

Since this is OS/2, 
you can continue edit¬ 
ing while the compiler 
is running. Compiler 
output is placed in a 
process buffer, and a 
window is opened for 
the buffer. Double¬ 
click on any message, 
and a window is 
opened showing the 
module and line in 
error. Press the key 
for next error or previ¬ 
ous error , and you are 
moved to the next or 
previous line that gen¬ 
erated a message. 

Visual SlickEdit 
supports several ver¬ 
sion control systems, 
including TL!B and 
PVCS for OS/2, Using 
the Project menu, you 
can check files in or Figure 1. Configuration dialog. 


out. I especially liked that a window is dis¬ 
played for you to enter the description of the 
change when you check a file into PVCS, The 
editor doesn't simply start a command win¬ 
dow and let you deal with the prompts—it 
effectively wraps a graphical front-end 
around the character mode version control 
system. As with all of Visual SlickEdit, you 
can configure the version control check in 
and out process to operate as you wish. 

Tags allow you to locate and edit func¬ 
tions quickly. You can generate tags for 
individual files or for an entire project. Once 
the tag file has been created, position your 
cursor on a function name, press Ctrl-K and 
a window will be opened showing that 
function. 

Visual SlickEdit gives quick access to 
OS/2 programming references. Place the 
cursor on a function or symbol, press 
Ctrl+Fl, and the help entry for that function 
will be displayed. This lets you look up the 
parameters for WinCreateVindoy or fopen 
quickly. 

Searching capabilities are powerful. 
Regular expressions are supported. The 
search can encompass one file or many files. 
When you are searching multiple files, a 
search result window, showing all matches, 
is displayed. Pick the match of interest and 
press the GoTo button to open that file. 


/One Fl«t per Window 
V AH Menu Hotkeys 
/Crrafline Prompting 

□ Alt Menu 

□ Keep dir 
/ Change dir 
JTpp of File Line 
/Delay File Lists 

□ Hide House Pointer 
/ Horizontal Scroll Bar 
/ Vertical Scroll Bar 
/ Show Button Bar 
/ Button Bar Messages 
□Short Key names 

Split file Path; 
Word Help FIename(s>; 
Bufrer Cache Size (k): 
State Cache Size (k): 
Window Left Margin (Inch); 

Max Clipboards; 


Emulation 

4 QUA Windows 
Q SlickEdit 
G Brief 
j EH ACS 
G VI 

-Search Options 

□ Match Case 

□ Regular Expression 

J Wrap at beginnlng/ond 
/ Restore Cursor after Replace 
/ Leave Selected 


Save Configuration^ 
Bedeflne Common Keys... 


File Extension Setup 


key Bin dings 


File Load/Save Options,*. 


r 


Colors... 


More Options,., 
Select Styles,., 


AutoSave.., 


j 


% (HE L PWDX ); c mdr ef inf 
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zee 
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Font.. 


List Source for Configuration*.' 


Update & Close | Cancel 


Help 
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Figure 2, Main editing screen. 


amples on how to program in Slick-C. 

The macro programming lan¬ 
guage itself is straightforward. 
Programming it does require learning 
a large set of Visual SlickEdit func¬ 
tions, For example, this small macro 
inserts //at the beginning of every line 
in a marked block: 

defmainO 

/* Puts // in front of selected lines 
*/ 

{ 

if (beginselect()) return ("); 

bl=p_line; 

end_select() 

el-p,line; 

for (i=bl;i<=el;++i) { 
p_llne^i- 
beginJineO; 
keyin "// " 

} 

deselectO; 

> 


Incremental searching is especially 
convenient* Just start typing and the 
cursor moves to the next Location in 
the file that matches what you have 
typed so far, 

A calculator is included, too. The 
calculator supports hexadecimal, octal, 
and binary computations as well as 
decimal. Calculations can mix different 
representations. If you don't need a 
full calculator, simple expression eval¬ 
uation is included on the command 
line* Type "math 2*2," press return, 
and Visual SlickEdit adds "=4" to your 
statement. Or type "math 0xAQO3," 
press return, and the decimal value 
will be displayed. The hexadecimal 
and decimal values are always dis¬ 
played on the status line below the cal¬ 
culation, so you can always see both 
representations. This is very useful 
when using APIs that have error 
returns documented sometimes as dec¬ 
imal and sometimes as hexadecimal. 

One of the less visible but power¬ 
ful features is the alms facility. In its 
simplest form, aliases can be used for 
command line expansion. For exam¬ 
ple, you can define "Iw" to be an alias 
for a fully qualified path to a file name. 
Select File/Open, type "Iw," press 
Ctrl+Spacebar, and the fully qualified 
name will be substituted for "lw." A 
more complex use would be to auto¬ 
mate code or documentation templates 
in a file. You could type "f," press Ctrl- 
Space, and create a function header for 
the language you are using, I plan to 
use this feature for documenting func¬ 
tions and creating skeleton programs* 

Visual SlickEdit also has text and 


binary file comparison, a file manager, 
split windows, begin/end structure 
and brace matching, and more. 

Macro programming is the key to 
extending the power of Visual 
SlickEdit, The Slick-C macro language 
is a type less, C-like language* To ease 
macro creation, macros can be recor¬ 
ded from keystrokes and saved for 
later editing and expansion. Macros 
are source and binary code compatible 
on all OS/2 and Windows platforms, 
making it easy to develop tools for 
cross-platform development. More 
than 130 macro files are included with 
Visual SlickEdit. These all serve as ex- 


DOCUMENTATION 

Visual SlickEdit comes with a 650-page 
manual of which 130 pages cover con¬ 
figuration and use. The majority of the 
manual describes the Slick-C program¬ 
ming language. The configuration sec¬ 
tion contains the information you need 
to use Visual SlickEdit effectively. 
However, this section is not well orga¬ 
nized, so you may need to hunt 
around a bit for the information you 
need. I did find the table of contents 
useful for locating information* The 
documentation is clearly written and 
easy to understand. 

The programming language is 



Figure 3. File extension options. 
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Figure 4 L Project options 


described in 80 pages; the remaining 
570 pages are an alphabetical reference 
of ail of the macro functions. The lan¬ 
guage description provides a good 
introduction to the language and the 
philosophy behind it. A nice touch is a 
section describing common program¬ 
ming mistakes. These mistakes are 
used to illustrate how the language 
works. In the reference section, the 
macro functions are briefly described 
in one or two sentences* More detailed 
explanations and examples are 
included for more complex macros. 
Slick-C is yet another language to 
learn—1 would have preferred 
REXX—but it appears to be relatively 
approachable. Visual SlickEdit's macro 
recording provides a good way to get 
started learning the language* 

WARTS AND BLEMISHES 

Visual SlickEdit for OS/2 is very simi¬ 
lar to Visual SlickEdit for Windows 
and reflects a Windows user interface 
design* Configuration involves an 
extensive set of nested dialogs. As 
usual with nested dialogs, it is easy to 
forget exactly where you are. The 
OS/2 notebook control could organize 
configuration information much more 
effectively. Other dialogs, such as the 
File Open dialog, reflect a Windows 
design- 

Visual SlickEdit uses the Multiple 
Document Interface (MDI) paradigm 
for organizing windows. All windows 
that you open are children of the client 
area of the main Visual SlickEdit win¬ 
dow. You can arrange the windows as 
you wish; Window menu items will 


arrange all windows as cascaded or 
tiled. The MDI main window reduces 
the maximum vertical size of each 
window you open, as the main win¬ 
dow has tool bars, status lines, and 
more. I would prefer to see windows 
be children of the desktop instead, as 
is the conventional practice for OS/2. 
The user would then be able to use 
screen space more effectively. 

While Visual SlickEdit emulates 
keystrokes for Brief, it will not execute 
Brief macros nor is a conversion utility 
available. You must thus convert Brief 
macros manually, learning the Slick-C 
language along the way. However, the 
product includes a very rich set of 
macros. I found that Visual SlickEdit 
had equivalent functions for some of 
the Brief macros that 1 rely on when 
writing programs. 

The tag function is overly gener¬ 
ous about identifying functions. In my 
testing, it "found" function definitions 
in comments. The only way to be cer¬ 
tain of what is a function definition is 
to actually parse the file using the syn¬ 
tax rules of the language. This is 
apparently not done. 

I normally set my default system 
font to 8.Helv rather than using the 
default System Proportional font* I 
could not do that with Visual 
SlickEdit. When I changed the system 
font, text and spacing in some dialogs 
were altered so much that I could not 
read the dialog at all. The problem was 
not the usual text clipping but a more 
extensive alteration. 

Visual SlickEdit optionally locks 
files in a network environment to 


reduce the risk of two people changing 
the same file at the same time. The sec¬ 
ond copy of the file is opened in read¬ 
only mode and is refreshed with 
changes made on the other copy. 1 saw 
a few odd behaviors, such as the 
refresh not always occurring, but over¬ 
all I found the network support to be 
satisfactory. 



TECHNICAL SUPPORT 

MicroEdge supports Visual SlickEdit 
on CompuServe. GO SLICKEDIT and 
select message and library section 13, 
MicroEdge Inc. I found several mes¬ 
sages posted on the forum each day. I 
posted several questions and reported 
two problems. My questions were 
answered the next day. Updated ver¬ 
sions of Visual SlickEdit or macros to 
fix problems were uploaded to the 
library within a day or two. I could 
hardly ask for better support! 

As this review was completed, 
MicroEdge released an update to sup¬ 
port the IBM WorkFrame product. 
The update is available for download¬ 
ing from their forum. 

SUMMARY 

I have resisted converting to a graphi¬ 
cal editor because of my large invest¬ 
ment in Brief macros for documenting 
and organizing code. With Visual 
SlickEdit, I may finally take the plunge 
and convert my macros. Visual Slick- 
Edit is powerful, flexible, and a delight 
to use. It's a definite keeper for my 
toolbox. 


Guy Schart is president of Software 
Architects, Inc., a software development firm 
specializing in developing OS/2 Presentation 
Manager applications for vendors and busi¬ 
ness . He can be reached at 76702 557@com- 
puserve.com or at Software Architects, Inc, 
2162 Jardin Drive , Mountain View, CA. 


PRODUCT INFORMATION 

Visual SlickEdit for OS/2, 
version 1.72.....$295 

Vendor; MicroEdge 
P.O. Box 18038 
Raleigh, N.C. 27619-8038 
Phone: (919) 831-0662 
Fax: (919) 831-0101 
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In this issue, your feline-loving furballs investigate dialogues from a C++ 
perspective. 

By MARK BENGE and MATT SMITH 


Manipulating 
Dialogues in C 



Malt Smith 


M V ecisions, decisions, decisions. While 
m m investigating the possibility of pro- 
vidtng C++ wrappers for the print 
API discussed in our previous three 
columns, we reached the conclusion that 
such an effort was premature in light of our 
abundant use of dialogues. As Mark's five- 
year-old nephew, Andrew, might put it, 
"Ding, I've got it!" A bell went off in our 
collective heads. What was that bell? 
Wouldn't it be nice to investigate and de¬ 
velop a set of C++ classes that have the ca¬ 
pability of processing a dialogue template, 
thereby generating the appropriate C++ 
control classes that wrap the controls in the 
template? Yup! We thought so too. 
Therefore, our goal is to provide you with 
the necessary classes and implement them 
using the IBM Open Class Library. 


THE INVESTIGATION 

There are a number of ways we can tackle 
this assignment, with each way achieving 
the common goal: 

1) Load the dialogue template using a 
class derived from IF rameWindow and use the 
nested class IVindow: :ChiIdCursor to iterate the 
child controls in the dialogue. Use the 
Win Query CLa $$N ame API to determine the type 
of control based upon its Presentation 
Manager window class, subsequently creat¬ 
ing C++ objects for each control. 

2} Derive a new class from IFrameWindow 
and, in the constructor for this new class, 
load the dialogue. Provide a member func¬ 
tion that loads the dialogue template from 
the resource via the DosGetResource API. Use 
the information in the dialogue template to 
iterate the various child controls in the tem¬ 
plate and create a corresponding C++ object 
for each control. 

3) Derive a new class from IF ram e Window 
and, in the constructor for this new class. 


++ 


load the dialogue template from the re¬ 
source via the DosGetResource API, Use the in¬ 
formation in the dialogue template to iterate 
the various child controls in the template 
and create each control using the 
WinCroa to Window API, A corresponding C++ 
object can be created for each control by 
using the window handle returned from 
WinCreateWindow. 

Each solution has its merits, as well as 
its faults. The first solution is more of a C++ 
solution than the other two, as most, but not 
all, of its implementation is in C++. The sec¬ 
ond solution seeks to take advantage of 
Presentation Manager's support for dia¬ 
logues, and the third solution places all the 
dialogue processing under your control. We 
chose the second solution for a number of 
reasons: 

• Taps Presentation Manager's dialogue¬ 
processing capabilities 

• More intuitive for C programmers who 
have dialogue backgrounds 

• Potential bridge for C programmers who 
are seeking to transpose their work to 
C++ 

• Performance. 

ON TO THE CHASE 

The base class that we developed for the 
processing of dialogue templates, Dialog, is 
derived from IFrameWindow, taking advantage 
of some of the support that IFrameWindow al¬ 
ready has for dialogues. The Dialog class 
constructor, shown in Figure 1, is imple¬ 
mented using various C++ classes. The dia¬ 
logue is loaded by the member function, 
IResourcoLibrary: :loadDialog. This function uses 
the WinLoadDlg API to perform the load. If the 
load fails, IResourceLibrary: rloadOialog will 
throw an IAccessError exception. 

Why do we load the dialogue and dia¬ 
logue template in separate steps? Can't we 
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load the template and create the dialogue in 
one step to help our performance? Nope! 
We can only iterate the child controls in the 
dialogue template to create C++ objects after 
the base Dialog class is constructed* We are 
calling virtual functions that may be overri¬ 
den in a derived class, which means the de¬ 
rived class must exist, or we end up calling 
the virtual functions in the base class. We 
will discuss this approach in more detail 
later, 

A couple of other points from the con¬ 
structor in Figure 1 that are worth mention¬ 
ing are the rThread: : current 0: :initializeGUI(), 
and the IFrameVindoystart function call, 
XThread: :current() ,initializeGUI() initializes 
the Presentation Manager environment by 
calling the Winlnitialize and WinCreateHsgQueue 
APIs* The IFrameVindow:: start function creates 
a new frame handler and adds it to the 
frame window, initiates message handling 
for the window, and adds the window to the 
internal window list that is maintained by 
the IBM Open Class Library. 

TO ITERATE OR NOT TO ITERATE 

Once we have loaded the dialogue and the 
dialogue template, we can iterate the tem¬ 
plate and construct the corresponding C++ 
objects for the child controls. We use the in¬ 
formation contained within the template to 
determine the number of child controls, the 
type of control, the individual control IDs, 
and the control style. Why is the control 
style important you may ask? You must use 
the style to determine the type of button and 
static control you are processing, because 
multiple button and static controls rely 
upon the WC_BUTTON and WC_STATIC 
window classes, respectively. 

In our default implementation, we have 
chosen to iterate the template and construct 
C++ objects for each of the child controls, 
immediately following the loading of the di¬ 
alogue. The dialogue is loaded in the Dialog 
constructor, and the C++ objects are con¬ 
structed in Dialog::createControlsFromTemplate. 
Using the default implementation, C++ ob¬ 
jects are constructed for each child control 
that has an ID other than -1; child controls 
with an ID of -X are skipped. However, you 
can defer the construction of the C++ objects 
until they are needed, by simply leaving out 
the call to Dialog;:createControlsFromTemplate. 
When you need to construct a C++ object, 
member functions are provided that allow 
you to easily create an object for a specific 


child control. All you need to supply these 
member functions is the child control's ID. 
Each of these functions is identified by the 
"Vithld 11 suffix. An example is Dialog:: 
checkBoxWithld, as shown in Figure 2. We will 
discuss the elements of this function in more 
detail later. 

During the iteration of the child con¬ 
trols in the dialogue template, we use the 
offQassName field within the DLGTTEfl structure 
to determine the type of control, (This tech¬ 
nique is the same used in the PDSGetTemplate 
function that is found within the supporhc 
module from previous article sources,} If the 
ID is not -1, we construct a C++ object using 
the constructor that is designed for the cre¬ 
ation of an object from a dialogue template. 
Each Presentation Manager control wrapper 
within the IBM Open Class Library has this 
type of constructor that accepts a window 
ID and a pointer to the parent window ob¬ 
ject. After the object is created, we call the 
member function, Window: :setAutoDeleteObject, 
which results in the destruction of the object 
when the Presentation Manager window is 



Figure 1 , Constructor for dialog . 
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Figure 2. Dialog: :cbeckBoxWithld member function. 


destroyed. Our final act is to call a 
protected virtual function, passing a 
pointer to the newly created object. 
The default implementation of these 
functions does nothing. You must 
override them in a class derived from 
Dialog to add the desired behavior. A 
small snippet of code shown in Figure 
3 illustrates these steps in relation to 
the check box control. We must use 
the style as well as the button window 
class to identify the check box, 

SUPPORTED CONTROLS 

All of the controls that are supported 
by the Dialog class are listed in Table 
1. The controls that are not supported 
are the valueset and most of the multi- 
media controls. The valueset is not 
supported since it is not yet supported 
by the Open Class Library. However, 
you can implement support for the 
valueset via the valueset C++ wrapper 
that is discussed in the book, OS/2 
C++ C/tfss Library Power GUI Pro¬ 
gramming with C Set++, 


sidtcH ( pdlgt->adlgtL[i] .offda$sNaifi ) 

i 

case WINCUSS.BUnON : 

{ 

unsigned long ulStyle * p<flgt->adlgti[i].fl£tyle k 

BS.PRBMMSTYLES; 

switch { ulStyle ) 

case BS^CHECKBQK: 
case SSJUTDCHECKBOK: 

{ 

ICheckBo** 

pQieckBo* 1 new ICheckSod ulld, this 
pChetk8o*->setAutQDeleteQbject( true ); 
checkfiod pCheckBox ); 

} 

break; 


Figure 3. C++ object construction 


WHA T ABOUT CUSTOM CONTROLS? 

Custom controls are also supported to 
an extent. We detect the presence of a 
custom control in the Dialog class con¬ 
structor by interrogating the value of 
the cchClassName field of the DLGITEM 
structure. If it is nonzero, we assume 
that it is a custom control and call the 
member function. Dialog: icustomControl, 
passing the window ID and a constant 
reference to the class name string as 
parameters. The default implementa¬ 
tion of this function does nothing. You 
must override this function in a class 
derived from Dialog, to properly 
process the custom control. 

DEFERRED CONSTRUCTION 
OR IS IT A QUERY? 

In Figure 2, we show a member func¬ 
tion, Dialog: reheckBoxWitfold. This func¬ 
tion and the other "xxxlxxlfitlild" func¬ 
tions play multiple roles. You can use 
them for deferred construction of C++ 
objects or for querying an object that 
already exists. In Dialog;:checkBoxVithid, 
IHindow:: windowVithOwner is called to ob¬ 
tain a pointer to the check box 
object that corresponds to the 
passed ID. If a NULL pointer is re¬ 
turned, we attempt to construct a 
check box object, and call 
IVindow::setlutoDeleteObject, to 
allow the IBM Open Class Li¬ 
brary to manage the destruction 
of the object when the check box 
window is destroyed. Why do we 
say attempt, and why do we not 
throw an exception on a failed at¬ 
tempt? If the object construction 
fails, the IBM Open Class Library 
throws an exception for us. If a 
non-NULL pointer is returned by 
IVindow:: windowVithOwner, the call to 
Dialog:rcheckBoxWithld is, in es¬ 
sence, a query, and the pointer is 
returned to the caller. 

SAMPLE DIALOGUE 

The sample driver application il¬ 


lustrates some of the things previously 
discussed. A new class, SampleDialog, is 
derived from our base Dialog class, 
SampleDialog is designed to support a 
sample dialog that we have cobbled 
together to show how to provide con¬ 
trol interaction from a C++ perspec¬ 
tive. As mentioned, we create C++ ob¬ 
jects for the child controls by calling 
Dialog: :createControlsFroiriemplate. This 
function is called from within the 
SampleDialog constructor. 

GETTING A HANDLE ON THE HANDLERS 

Once we have the C++ objects con¬ 
structed, our next step is to attach gen¬ 
eral purpose handlers to process the 
various window events generated by 
the controls. The first handler class we 
would like to attach is a command 
handler, XComaandHandlen We use an 
ICommandHandler to process the com¬ 
mand, Vfl_CQNMAND, event that is gener¬ 
ated by clicking on the "Query' 1 or the 
"Cancel" push button shown in Figure 
4. In our driver application, we derive 
a new class, SampleConmandHandler, from 
IConrnandHandler and override the mem¬ 
ber function, ICommandHandler::command, 
SampleCommandHandler:: command processes 
the command event, and as you may 
notice when you preview the driver 
application, it bears a strong resem¬ 
blance to a window procedure. 
SampleComrtiandHandler is attached to the 
sample dialog by calling IHandXer. zhan- 
dleEventsFor from within the SampleDia- 
log constructor. 

The cancel processing within 
SampleComni and Handler:: command is, as you 
have guessed, a dismissal of the dia¬ 
logue. The query processing, although 
more involved, is still quite simple. 
We query the selected item's text 
within the combo box and the list box, 
as well as the current value in the nu¬ 
meric spin button. We display the text 
and value with the multi-line edit 
(mle) control. 

Note that the return code for a 
handler has significance. A return 
code of false indicates that the event 
may be dispatched to other handlers 
for processing or that it may be 
processed by the default window pro¬ 
cedure, A return code of true indicates 
that processing of the event has fin¬ 
ished, However, if you return true, 
you may also be required to set an 
event result via lEvent::setResult. Most 
events do not require the setting of re¬ 
sults, but be aware of those that do. 

The next handler class we would 
like to attach is a select handler, 
ISelectHandler. We use an ISelectHandier 
to process the selection, LN_SELECT, noth 
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Figure 4 A handler is selected by generating an item in the list box. 


fication event that is generated by se¬ 
lecting an item in the list box shown in 
Figure 4. In our driver application, we 
derive a new class, SampleSelect Handler, 
from IS elect Handler, and override the 
member function, ISelectHandler::se¬ 
lected. SampleSelectHandler is attached 
to the sample dialog by calling 
IHandler::handleEventsFor from within 
the SampleDialog constructor. 

SampleSelectHandler:: selected pro¬ 
cesses a selection event and writes the 
selected item's text into the static text 
control 

YOU ARE BEING OBSERVED 

Most of us have dealt with the nu¬ 
ances of control event processing at 
one time or another. Since many of the 


notification values overlap between 
controls, you must determine the con¬ 
trol type prior to tackling the notifica¬ 
tion value. We use the notification 
framework in the IBM Open Class 
Library to remedy that headache. 
Rather than using integers to repre¬ 
sent the notification event, unique 
strings are used instead. 

We derive an observer class, 
SampleObserver, from lObserver, overrid¬ 
ing the pure virtual function, lOb¬ 
server: :dispatchNotificationEvent. Sample- 
Observer:: dispatchNotificatiofiEv ent contains 
our logic for processing the ICir- 
cularSlider::valueId notification. We 
use the information that is passed by 
the notification event class, noti¬ 
fication Event, to update an entry field, 


GUI Corner on the Internet 

Announcing the opening of Tails from the Trenches home page in 
the GUI Corner web page, http://www.prominare.com/prominare/gui- 
corner.taitsfromtrenches.html. This home page is dedicated to the 
timely release of "kitty treats," as they become known to us. In case 
you have forgotten, our other home pages are http://www.promi- 
nare.com/ prominare/guicorner.html, which is a respository for current 
and past code examples, and http://www.prominare.com/prominare/ 
guicorner.catsmeow.html, which contains errata. 


as well as a progress indicator (a 
read-only slider). 

We enable observer notification 
within SampieDialog: :circularSlider by 
calling ICircularSlider: renableNotifica- 
tion. Our observer, SampleObserver, is at¬ 
tached to the circular slider in this 
function via lObserver::handleNotifica- 
tionsFor. We encourage you to explore 
the code, as the sample driver should 
make things dearer. On a final note, 
you need to attach the observer to the 
control you are observing. It does not 
work if you attach the observer to the 
owner of the control. 



HANDLING DIALOGUE INITIALIZATION 

We've purposely avoided the issue of 
handling dialogue initialization. Our 
general purpose handlers cannot be 
used to process the dialogue initializa¬ 
tion, WH.INITOLG, event, since we are 
specifying VinDefDlgProc as the dialogue 
procedure when we call IResourceLi- 
brary; :loadDialog. Special logic is re¬ 
quired to enable initialization process¬ 
ing, and because this logic has already 
been implemented elsewhere, we do 
not want to "re-invent the wheel". An 
excellent implementation is provided 
in the book, OS/2 C++ Class Library 
Power GUI Programming with C Sef++ 
on pages 464-471. 

CONCLUSION 

The sample driver application, al¬ 
though simple in scope, illustrates 
some powerful concepts. A common 
problem faced by users of the IBM 
Open Class Library is how to support 
legacy resources from the context of a 
C++ class library. Hopefully, we have 
given you a set of classes that you can 
use to implement support for your 
legacy resources from a C++ class 
library. 

One possible extension of the 
Dialog class is to convert a dialogue 
template into a canvas. As is the case 
for dialogue initialization, we will 
avoid this issue and leave it as an ex* 
ercise for the brave at heart. 

Please keep those calls, letters, 
and suggestions coming, and we will 
try to incorporate your suggestions 
into future columns. 
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Buttons 

Check box (including auto style) 

Push button (including graphical style) 
Radio button (including auto style) 
User-defined button 
3-State check box (including auto style) 
Circular slider 
Combo box 
Container 
Entry held 
List box 
Multi-line edit 
Notebook 
Scroll bar 

Slider (including progress indicator) 

Spin button (both text and numeric only) 
Static 

Bitmap 
Group box 
Icon 
Text 


Table l Supported conditions. 
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Programming Insider 

In this issue's "Programming Insider," well explore how IBM's new Developer API 
Extensions help you, IBM, and the programming community whether you already have 
OS/2-exploitive applications, are writing for Win32, or whatever your plans may be. 

By DAVID E. REICH 


Extending the 
OS/2 API 


ack in May, at the IBM Technical 
Interchange in New Orleans, IBM 
announced extensions to the OS/2 
API set. They were dubbed "IBM Developer 
API Extensions". Whatever they're called 
when they're released, they are simply new 
OS/2 APIs for use by application develop¬ 
ers. These APIs happen to have the same 
names, parameter lists, and functions as 
their Win32 counterparts. 

WHA 7 ARE THESE EXTENSIONS? 

The developer API extensions are just that. 
They are new APIs, or programming inter¬ 
faces, for use by any application developer. 
IBM is always adding new APIs to the sys¬ 
tem. Some are newly published interfaces to 
existing function (the oft-mentioned "docu¬ 
ment the undocumented interfaces" re¬ 
quest), and some are interfaces to new func¬ 
tion added to the operating system. These 
developer extensions are no different. 

The new function list, published at the 
IBM Technical Interchange and found in a 
White Paper on the IBM Software De¬ 
veloper's home page on the World Wide 
Web at http://www.austin.ibm.com/devel- 
oper, is a list of over 700 APIs and 300 mes¬ 
sages that correspond in interface and func¬ 
tion to Win32 APIs and messages with the 
same names. The idea behind this is to cre¬ 
ate a level of source code compatibility be¬ 
tween applications written for Windows NT 
or Windows 95 and OS/2. 

WHY? 

IBM understands that this API/message list 
will not create complete source code com¬ 
patibility, and many people have ques¬ 
tioned the motivation behind fundamen¬ 
tally supporting Win32 APIs in OS/2. The 
major concern among developers is, "Isn't 
this conceding the API 'wars' to Microsoft, 


and isn't IBM now letting Microsoft take 
control of the API?" This question needs to 
be asked, and the answer, while a religious 
subject for many, makes sense when viewed 
in the big picture. 

Let's face it. There are many OS/2 ap¬ 
plications on the market. There are many 
more Windows applications. It is a simple 
matter of economics. With limited resources 
on the part of developers, the migration is 
to the larger installed base. For now, that is 
Windows. With the single-threaded, 16-bit 
architecture of Windows, APIs aside, there 
are fundamental architectural issues that 
made source code compatibility impractical 
before now. Even if the API were identical 
between OS/2 and Windows, the "16-bit- 
ness" of the applications and the single- 
threaded architecture of Windows would 
create OS/2 applications that would not ex¬ 
ploit the advanced functionality offered by 
OS/2 and as such, no compelling reason for 
people to buy them. 

Now that applications supporting mul¬ 
tithreading and 32-bit function are being 
developed, it makes much more sense to do 
something like this now rather than earlier. 
So why does IBM want to support Win32 
APIs? 

The plain fact is that there are develop¬ 
ers creating Win32 applications. In the past, 
OS/2 applications have not kept pace with 
the functionality that was offered in their 
Windows counterparts, because Windows 
was being developed for first. What the 
market was seeing was a MyApp version 
5.0 for Windows, while version 4.0 was the 
current native OS/2 version of MyApp. 
This could not continue if OS/2 was to 
thrive and grow. 

The primary hurdle is money. (Isn't it 
always?) Maintaining two sets of source 
code to do the same thing on two different 
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platforms does not make financial 
sense* If one could leverage the source 
code and reduce the cost to keep the 
same features in both OS/2 and 
Windows versions of the same appli¬ 
cation, it would, to a considerable ex¬ 
tent, level the playing field to get ap¬ 
plications on OS/2, with the same 
level of function. This is better for 
both OS/2 and application vendors in 
that they can sell more* 

The Developer API Extensions 
add new functions to OS/2 (such as 
common dialogs, DDEML, and Re¬ 
gistry functions, among others) and 
provide interfaces to the existing 
function so that yon can just recom¬ 
pile a significant portion of your ap¬ 
plication and have native OS/2 func¬ 
tionality* In fact, IBM analyzed over 
nine million lines of shipping 
Windows application source code to 
determine which list of functions to 
support first, in order to create an ap¬ 
proximate 80% common source code 
base. The other 20% will be operating 
system-specific function, such as 
Workplace Shell exploitation, as well 
as other functions the other platform 
does not support. Figure 1 shows how 
you can manage your source code ef¬ 
ficiently to make the most use of both 
environments. 

So, in getting back to the question 
of conceding the API to Microsoft, 
IBM is tactically supporting the APIs 
that enable inexpensive migration to 
OS/2* This provides the buying pub¬ 
lic with applications that have the 
same functions on both OS/2 and 
Windows and lets them choose the 
platform that best fits their needs. No 
longer does the application have to 
dictate the platform, and users who 
have their operating environment 
provided for them can use your appli¬ 
cations on either* 


ADVANTAGES 

Some of the advantages for you, the 
programmer, are reduced cost for 
multiple platform source code, lower 
product documentation costs, and 
more function added to OS/2. After 
all, if the application is common in 
features across platforms, why rewrite 
and republish the documentation? 

Another advantage is for custo¬ 
mers, because there are lower learn¬ 
ing curves (or one curve for cus¬ 
tomers with multiple operating 
system installations), and there are 
products that are up to date function¬ 
ally. There may be customers who 
have standardized on an operating 
platform (or may be contemplating 


movement to another), and with your 
programs, you can be there whether it 
be Windows or OS/2. The choice is 
even easier for the customer, knowing 
your application is just as functional 
on both systems and with no addi¬ 
tional learning for users. 

HOW CAN YOU USE 
THESE EXTENSIONS? 

The API extensions are just new func¬ 
tions in the operating system. As 
stated previously, some of the APIs 
are just new entry points into existing 
function, with new names and para¬ 
meter lists that match what the Win32 
APIs use, and some have new func¬ 
tion underneath. Examples of new 
function are the Find and Replace dia¬ 
log, the Print dialog, and DDEML 


functions to simplify the use of 
Dynamic Data Exchange (DDE). 
Many programmers have requested 
more common dialogs in OS/2 in ad¬ 
dition to the Font and File dialogs al¬ 
ready present, and these, with the 
many new functions, provide a com¬ 
plete and robust programming model 
Using the extensions is easy. 
Because they are just new APIs, you 
can use them as you would any other. 
It's as simple as that. While at the 
time of this writing, the entry points 
are not shipping in a publicly avail¬ 
able version of OS/2, IBM plans on 
adding these to future OS/2 versions. 
You can make use of them in a beta, 
however, to develop your applica¬ 
tions. Even if you don't have a beta, 
you can simply adhere to the API list 
in your development and cross com¬ 
pile for the other platform when 
you're done. Refer back to Figure 1 to 


see how to structure your code to 
maximize your investment in source 
code and leverage two platforms at 
once, 

THE FUTURE 

So what's IBM getting at with all of 
this? Basically, developers should not 
have to choose which platform to re¬ 
lease an application. With a common 
source code base, you can support 
different platforms. After all, that is 
where the software world is heading: 
reuse and portability. 

For your procedural code base, 
the Developer API Extensions provide 
that portability. Using a standard C or 
C++ compiler, you can cross compile 
the platform independent code (using 
the extensions) and exploit the appro¬ 


priate platform with the other part of 
your code. This lowers the entry point 
into other markets where you might 
not otherwise want to enter, given the 
costs of a complete rewrite. 

If you are already making a move 
to objects, the IBM Open Class prod¬ 
uct, along with OpenDoc, will pro¬ 
vide you platform independence. IBM 
Open Class will be on OS/2, Win¬ 
dows, and other platforms, just as 
OpenDoc is headed there as well. I try 
to stay away from commenting about 
things that are not vet shipping, but 
in the context of mapping out a strat¬ 
egy for you, and "Designing High- 
Powered OS/2 Warp Applications" (a 
topic that is near and dear to my 
heart), while retaining the ability to 
move to many platforms at a negligi¬ 
ble cost, I'll tread softly on that line. 

So, for procedural code, the De¬ 
veloper API Extensions get you com- 



Figure 1 . How to manage your source code efficiently. 
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Fast Visual Application Development 

for OS/2 and DB2 


If you’re looking for fast and easy application 
development for OS/2, then take a look at the award¬ 
winning Watcom VX'Rexx visual development 
environment. VX*Rexx lets you build applications to 
exploit the graphical user interface, multi-threading, 
and multi-processing power of OS/2, VX*Rexx 
C lient/Server Edition gives you the added power to 
access DB2 or other database systems, manipulate the 
data, and chart the results at lightning speed. 
u We like VX*Rexx. Using it for development feels like 
driving a Porsche: it's fast, it's compact, everything's 
in the right place , and it makes us look good, too. ” 

Peter Coffee, PC WEEK 

Designed to Meet Your Needs. 

Watcom VX*Rexx combines a project management 
facility, visual designer and an interactive debugger to 
deliver a highly productive visual development 
environment. The Client/Server Edition includes 
additional powerful objects so you can rapidly create rich GUI database 
applications. You can create OS/2 client applications which connect to 
DB2/2 or DB2/6000, Use IBM’s DRDA support on OS/2 to access DB2 for 
MVS, DB2/40Q for AS/400, and DB2/VSE and VM (SQUDS) for VM and 
VSE, Also supported are Watcom SQL and ODBC-enabled databases . 
“Overall, this edition of VX*Rexx for OS/2 is an outstanding visual 
client/server development platform:' Nicholas Petreley, Inf eWorld 
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To create an application you draw user interface objects, customize their 
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“Drag-and-drop nirvana.” Nicholas Petreley, Info Wo rid 

Give Your Data a Whole New Image. 

Energize your applications by displaying your data in a 
3D chart. The Client/Server Edition gives you more than 
a dozen chart types to choose from, along with over 150 
display options. You also get complete support for run¬ 
time events so you can bring new drama to your data by 
making your chart interactive, 

“VX*REXX is a must buy:* Jacques Surveyer, 
ComputerWorld 

Standard or Client/Server Edition— 

Which one is for you? 

To start creating powerful OS/2 GUI applications right away, 
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order Watcom VX*Rexx Client/Server Edition for just. ,,$299 
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mon source code. For objects, IBM 
Open Class and OpenDoc get you to 
common code. Using these tools, you 
can spend your time (and money) de¬ 
veloping features for your applica¬ 
tions in order to differentiate you 
from your competitors, wow your 
users, and make yours the applica¬ 
tions of choice, rather than worrying 
about how to maintain function 
across multiple platforms. 

OTHER QUESTIONS 

One of the other important questions 
that I've been asked about the API ex¬ 
tensions comes from the concern that 
IBM is now lowering the entry point to 
the OS/2 application market for com¬ 
petitors of those who've supported 
OS/2 from the start. 

While this is an absolutely valid 
concern, several important factors are 
being overlooked. For example, if 
you've been developing for OS/2 all 
along, you've learned all of the tricks, 
have already fallen into the traps of 
multithreaded programming, and you 
know how to debug these types of 
programs. Developers coming from 
the DOS/Winl6 world have all this to 
learn. So to start with, your applica¬ 
tions will be better threaded on either, 
or both, platforms. 

In fact, if you want to get your 
OS/2 application onto Win32, you 
could even do it using these APIs. By 
moving your existing OS/2 code to 
the structure outlined in Figure 1, you 
can get into the Win32 market inex¬ 
pensively and be the best multi¬ 
threaded kid on the block. 

IBM's goal is to provide you, the 
developers, with the tools and vision 
to leverage your investment in code 
while at the same time drive IBM's 
business. The Developer API Exten¬ 
sions, combined with IBM Open Class 
and OpenDoc, will give you the pow¬ 
er and portability to make the most of 
your programming investments. It 
will also give your users the ability to 
choose the platform they prefer and 
choose your applications to run on it. 

You have the tools. How you use 
them is now truly your choice. 

David Reich has been with the IBM OS/2 
development team since W87. He has worked 
on many parts of the system, supported cus¬ 
tomers and application developers, and trav¬ 
eled the world giving seminars and teaching 
OS/2 . His latest book is , Designing High 
Performance OS/2 Warp Applications, pub¬ 
lished by John Wiley and Sons. He can be 
reached on CompuServe at 76711,632 or via 
the Internet at speedracer@bocaraton. ibm, com, 
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OS/2 for the PowerPC 

Migrating an application to a new platform can be a daunting task for a smalt software 
company. This time it was worth the gamble. 

By CHARLES DIRCKS 


OS/2 for the PowerPC: 
Fact or Fiction 


r Those of us in the programming 
community often hear about the 
promises of future operating sys¬ 
tems. If any of us had a dollar for each of 
those unfulfilled promises, our wealth 
would be more than acceptable—although 
still short of Redmond's most famous citizen. 
Perhaps we should conclude that it is more 
profitable to make promises than to fulfill 
them! 

Still, businesses are based somewhat on 
promises of the future balanced against 
needs of the present. Ours is no different, 
IBM has promised that the API set would be 
consistent for OS/2 whether the hardware is 
an X86 or a PowerPC. Our business needs 
depend on this promise. Our programming, 
we felt, would push the promise to its limits: 
the replacement of the WPObject Class. This 
article discusses our business requirements, 
programming approach, and experience 
with the API set with OS/2 as it applies to 
both the X86 and PowerPC platforms. 

BUSINESS BACKGROUND 

Pinnacle Technology was founded three 
years ago with four primary programming 


Centrally secure, manage, and 
store from a server (or host), 
(A different desktop for each 
group!) 



Your users get their desktops 
wherever and whenever they 
log on! 


Small file size allows 
for desktop security and 
delively to laptops over 
phone lines! 


objectives: make the OS/2 shell "user proof/' 
make OS/2 secure, make OS/2 desktops cen¬ 
trally manageable, and conserve bandwidth. 

These goals seem somewhat intimidat¬ 
ing to most programmers until you consider 
that the nucleus of our development team 
was from American Airlines Sabre: one of 
the world's largest commercial networks. 
Using our tools, system administrators can 
centrally create an ideal (and secure) OS/2 
desktop for a group of users. Whenever and 
wherever they log-on to their LAN, the users 
get their desktop with the appropriate re¬ 
strictions (such as no desktop pop-up menus 
or no copy or delete rights). 

With increased mobility in the corporate 
marketplace, we architected our file size to 
be very small. For example, the average un¬ 
compressed size of a desktop is about 2GK 
bytes. Compressed, we are less than 2K 
bytes. Therein lies our interest in the 
PowerPC. Within its architecture is a chip 
that offers about twice the speed of the 
Pentium at less than 1 watt:—about the same 
as a hand-held cellular phone. 

The goal is to offer the same secure desk¬ 
top to a hand-held device as to one that is 
LAN-attached with the same 
file. The user should not care 
whether they are using an Intel 
machine, a Pow-erPC, or a 
hand-held device. 


Figure 1 . OS/2 desktops are centrally administered and delivered to X86 or PowerPC machines. 


PROGRAMMING APPROACH 

Our design focused on effi¬ 
ciency. But paramount to our 
ability to deliver OS/2 desk¬ 
tops to variable machines is a 
rigorous adherence to OS/2 
APIs and a religious avoid¬ 
ance of any direct manipula¬ 
tion of the temperamental .INI 
files. The .INIs are, by their 
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Finder Object Details 


very nature, machine- and OS/2-version- 
specific. This point becomes important when 
the hardware platform evolves to the 
PowerPC as well. IBM has documented that 
the content and format of these files be 
changed only by the provided APIs. 

The nucleus of our desktop delivery is a 
SOM-based program we call Finder. On an 
OS/2 2.11 machine. Finder is able to quickly 
locate and hide all predefined objects so that 
our other tools can build the appropriate and 
protected desktop. Finder's class is depen¬ 
dent on our class replacement of WPObject. By 
replacing the WPObject class, we are able to 
carry our own instance data, making it possi¬ 
ble to extend the object out to the network 
under tight security controls. 

Capabilities on a Warp machine are 
greatly enhanced. Finder can quickly take a 
picture of the ideal desktop that an adminis¬ 
trator is creating for individuals or groups 
using OS/2 clients and apply various restric¬ 
tions to each object the user might access. 
This again is accomplished by a sophisti¬ 
cated object replacement technique that we 
apply to the WPObject class. Given its impor¬ 
tance to our desktop delivery and security 
products, the Finder is the portion of our 
code that we chose to challenge the portabil¬ 
ity of our OS/2 application to the PowerPC 
Platform. 

Replacing a class is not for the faint 
hearted, let alone the WPObject class itself. It 
strikes at the core of the operating system's 
capabilities. We therefore approached the 
project with at least some trepidation. 

The recompile of the Finder went very 
smoothly with no changes to any lines of the 
source code. The Metaware compiler per¬ 
formed flawlessly in building our complex 
DLLs. Installation was the only setback, 
which was overcome only by repeated at¬ 
tempts to perform the class replacement. 


REFERENCES 

"Load and Lock! Delivering a Consis¬ 
tent and Secure OS/2 Desktop Over any 
LAN," Personal Systems Magazine, July, 
1995. 

"1995 IBM U.S. Technical Interchange," 
Presentation Notes CD. 



Figure 2. Finder locates all objects on the desktop for administration. 


When we filed the problem resolution re¬ 
port, it stated that, "Installation was difficult 
due to the operating system being in beta." 
Let's call that a famous understatement. 

Once installed, the Finder performed as 
intended with no apparent differences be¬ 
tween the X86 and Power platforms. Our 
current plan is to provide Finder on the 
forthcoming Sampler CD for the OS/2 Warp 
Connect (PowerPC edition). 

CONCLUSION 

All companies need to conserve resources— 
some more than others. Still, we were more 
than curious to evaluate the effort to port our 
applications to the PowerPC. We asked our¬ 
selves what the historical costs were associ¬ 
ated with porting existing applications to 
other platforms (DOS to UNIX, Macintosh to 
Windows, or VM to CICS). In every case, 
only the largest companies have been able to 
bear the development costs of such an effort. 
Smaller firms do not even make the attempt. 
Our answer to the question, "Can we handle 
the cost of porting to the PowerPC?" is a re¬ 
sounding "Yes!" 


Charles Dircks is the chief security architect of 
Pinnacle Technology based in Indianapolis , In. After 
graduating from Indiana University with a degree in 
computer science in 1981 Charles has had an exten¬ 
sive career in developing bandwidth-sensitive applica¬ 
tions, which included over 10 years at American Airline 
Sabre. Charles was recently a featured speaker at 
IBM's Technical Interchange. 


SEPTEMBER/OCTOBER 19 9 5 
























Subscribe TodayT 


As an OS/2 professional, you may be eligible for a FREE one-year subscription 
to OS/2 Developer, the leading magazine dedicated exclusively to software 
developers working in the OS/2 environment. This bimonthly magazine is 
designed for OS/2 application developers who work with everything from LANs 
to multimedia to DBMS architecture. OS/2 Developer helps you optimize the 
performance of your OS/2 system and exploit 0S/2's complex features to the 
fullest It is your definitive source of; 

Source code examples OS/2 Programming tips and techniques 

Real-life case studies Development tool buyers guides 

New product announcements and more,,. 

To request your FREE subscription simply complete the form below today! 

I would like to receive/continue receiving OS/2 Developer 
free of charge; □ YESf □ No, 



FAX #: 708-647-5972 



Signature 


Pate 


(This card MUST be signed and dated, and we MUST have your address, in order to start or 
continue your subscription.] 

Print Name 


Title 

Company 

Address 

Dept/Malt Stop 

City 

State Zip 

Phone 

FAX 


My job function is (check only one): 




01 

□ 

Software programming 

07 

□ 

Computer operations supervision 

02 

□ 

Application development 

oa 

□ 

Database Administration 

03 

□ 

Software engineering 

m 

□ 

LAN support 

04 

□ 

Software quality assurance 

10 

□ 

PC software support 

05 

n 

Project management 

n 

□ 

Engineering, research, sciences 

06 

□ 

Technical support 

99 

□ 

Other {please specify) 

What is your company's primary area of business? 



(check only one): 




20 

□ 

Software 

26 

□ 

Value-Added Resei!er/VAR 

21 

□ 

Finance/Insurance 

27 

□ 

Non-computer manufacturing 

22 

□ 

Communications 

20 

□ 

Defense/Aerospace 

23 

□ 

Non-defense government 

29 

□ 

Wholasaie/retail trade 

24 

□ 

Healthcare/bi otechnology 

30 

□ 

Education 

25 

□ 

Computer-related manufacturing 

39 

□ 

Other {please specify): 


Free Subscription offer good in US. only. 

For subscriptions outside the U.S. please check and sign below: 

□ $55.95 Canada/Mexico |US funds onlyhair mail only 

□ $69,95 Outside North America (US funds only ha it mail only 

Signature Daw 

□ Charge my credit card (Visa, Mastercard, American Express) 

Card No.Exp. Data 

IMPORTANT: 

M questions must be answered in order to start or continue your subscription! 

1) My Company is part of the IBM Developer AssSstance^Pro^ram: 

If “yes", my company's DAP number is__ 


4) Do you work in IS/TIPT 

i □ Yes. 2 □ No. 

5) Do you design/write/customize software? 

1 □ Yes, 2 □ No. 

6) Which operating system do you use, use as a development environment and/or target for 
the software you develop? ( chock all that apply): 


2 ) My job title is (check only one): 

01 □ President, partner, chairman, owner 
Vice president, CFO, CIO 
Director, head, chief, general manager 
Department manager 
Supervisor 

Other middle management {team leader, project director, etc,) 
Other {please specify) __ 


□ 

□ 

□ 

□ 

□ 

□ 



Use for 

Target for 

Operating 

Use 

Development 

Development 

System 

01 □ 

zi n 

41 □ 

OS/2 v.2.it 

02 □ 

22 □ 

42 □ 

OS/2 vl.Jt 

03 □ 

23 □ 

43 □ 

Unix (AIX/XENOIX/AUX or 
any type of Unix) 

04 □ 

24 □ 

44 □ 

MS-DOS/PC-DOS 

05 □ 

25 □ 

45 □ 

Windows 3.x 

OB □ 

26 □ 

46 □ 

Windows NT 

07 □ 

27 Q 

47 □ 

SQL Server 

OB □ 

28 □ 

48 □ 

Apple System 7 

09 □ 

29 □ 

49 □ 

Other Macintosh OS 

10 □ 

30 n 

50 □ 

OS/2 Warp 

11 □ 

31 □ 

51 □ 

OS/2 for Windows 

12 □ 

32 □ 

52 □ 

Windows 95 

13 □ 

33 □ 

53 □ 

OS/9 

19 □ 

39 □ 

59 □ 

Other {please specify) 

20 □ 

40 □ 

60 □ 

None of the above 


18) Are you developing foe or supporting Lotus Nates? 

1 □ Yes 2 0 No 


HADT95 


FAX this to 708-647-5972 

or mail to OS/2 Developer, P.O. Box 1079 Skokie, IL 60076 



















OS/2 for the PowerPC 

A young, bleeding-edge software company migrates a bulletin board system to OS/2 for 
the PowerPC. 

By STEVEN TOWER and JOHN MORRIS 

Porting to the PowerPC 



Editor's note: AdeptSoft is one of those 
brave companies that signed up for IBM's OS/2 
for PowerPC beta program. Since many of our 
readers are contemplating the development or mi¬ 
gration of applications to this new platform, we 
asked AdeptSoft's pioneers to share their experi¬ 
ence with us. 

O n the road to IBM's OS/2 for the 
PowerPC, we expected a bumpy 
ride with lots of twists and turns, 
but instead we found the Autobahn. 
IBM promised that OS/2 for the PowerPC 
would be a painless move from the OS/2 
Intel platform as long as we met one main 
criteria: the application had to be a pure 32- 
bit OS/2 application, or using as few 16-bit 
calls as possible. 

LOOKING AHEAD 

About three years ago, AdeptXBBS started as 
a 16-bit OS/2 PM application. In a bold 
move, we made the decision to rewrite our 
application from the ground up for the new 
32-bit OS/2 with its Workplace Shell. This 
was a fairly drastic step. One of us had expe¬ 
rience ported 16-bit DOS applications to 32- 
bit OS/2. It was actually easier to do this be¬ 
cause the DOS applications didn't have any 
16-bit OS/2 API calls in them. Quite a bit of 
the OS/2 API had changed, either through 
the use of LONGs instead of SHORTs, or the 
more intuitive API naming scheme. Not to 
mention that some API calls had been 
dropped in favor of improved ones. At the 
time, the changes needed to make the pro¬ 
gram fully 32-bit left a bitter taste in our 
mouths. But it was one of the best moves we 
made in our development process. Once the 
conversion was complete, things were once 
again looking up. 

Being relatively familiar with IBM's 
Workplace OS/Microkernel strategy, and 
with some guidance from insiders at IBM, 
we kept on top of the design of Workplace 
OS/2 (now OS/2 Warp Connect [PowerPC 
edition]), following every move and making 
sure that we didn't use any unsupported 
APIs. 

One major decision, as part of our plan 


to make sure our application would run well 
and be able to follow IBM's operating system 
strategy, was to make sure that potentially 
nonportable code was put into a .DLL. By 
placing 16-bit and other nonportable calls 
into a .DLL, we reduced our porting time 
extensively. 

Over the last three years, development 
of AdeptXBBS continued at a blinding pace. 
In December, we received confirmation that 
we were in the IBM PowerPC beta program 
and would have our chance to prove that 
everything we had done was going to work. 

OUR FIRST POWERPC COMPILE 

IBM made it clear that if we had a pure 32- 
bit application, porting would be a simple, 
undaunting job. We still expected problems. 
The first beta (alpha?) release of the operat¬ 
ing system and the accompanying compiler 
were, shall we say, interesting. We decided 
to start by porting the hardest part of our 
product, the two .DLLs, with 16-bit calls. We 
figured that if we could get those two .DLLs 
to work, the rest would be a breeze. After a 
few days, we made our first test run. It didn't 
work. The operating system returned bizarre 
return codes that even some of OS/2's devel¬ 
opers couldn't explain. 



Figure 1 How little things can come back to "haunt" you. 
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At this point we decided to wait 
for beta #2 and just dean up the rest of 
our application code in preparation for 
the big port. Our application, a 32-bit 
PM BBS program, was still compiling 
with several warnings whenever we 
did a full compile. We decided to 
make sure our product would compile 
with absolutely 0 warnings and 0 er¬ 
rors. 

FROM WATCOM TO IBM TO META WARE 

For two developers with over 150,000 
lines of code sitting in front of them, 
this was no easy task. We started com¬ 


piling with Watcom's C v* 10.0. Once 
we had all of the *EXEs and .DLLs 
compiling with 0 warnings and errors 
under Watcom's C compiler, our next 
step was to get the same results with 
Watcom's C++ compiler. While doing 
this, several major problems appeared 
and were corrected. Next, we com¬ 
piled on IBM's CSet and CSet++ until 
the same 0 warnings and errors were 
achieved. We completed the process 
with Metaware's C++ compiler. We 
learned that by taking the time to do 
something that seemed trivial at the 
start, in the end we had a application 


that was not only able to compile flaw¬ 
lessly under three compilers, it was 
also faster, smaller, used less memory, 
and was more stable! 

WHO MAKES THE HIGHC 
COMPILER, META WARE? 

The compiler found on the IBM 
DevCon CD ROM was used for the 
final porting process. This compiler 
did not appear to build a functional 
executable file, but we were able to use 
it to get an understanding of how the 
HighC compiler differed from Wat¬ 
com's C or IBM's CSet++. The first 
thing that we discovered was that we 
didn't need to make any changes to 
our OS/2 API calls (Yeah!!!). Next, we 
discovered major differences in com¬ 
piler syntax between the Watcom com¬ 
piler and the HighC compiler. This is 
where 95% of the port occurred. 

NEW COMPILER SWITCHES 

As with most compilers, HighC has it's 
own unique compiler switches. Learn¬ 
ing these new switches is the first step 
to porting your application to the new 
PowerPC machine. 

TYPE CHECKING 

HighC has much stricter type check¬ 
ing. Get used to it. You may not like ail 
of the compiler warnings, or errors, 
but after correcting these problems 
you will have a more robust applica¬ 
tion, Figure 1 shows how little things 
can come back haunt you. 

MEMORY ALLOCATION 

Make sure you cast all of your memory 
allocation calls’ We had properly cast 
about 85% of ours, but the last 15% 
was what got us* Our application is 
heavily multithreaded, so we make 
several calls to the well-known _be- 
ginthreadO function. The HighC version 
differs from the call that most of us 
have gotten used to in that it has only 
three parameters. The pointer to a pre¬ 
viously allocated stack buffer is not 
present. This differs from the Watcom 
and IBM calls, which take four para¬ 
meters rather than three, The four-pa¬ 
rameter calling convention is a leftover 
from the 16-bit days and was appar¬ 
ently kept the same, so you wouldn't 
have to change this call if you were 
changing platforms. Since we have _ be¬ 
gin thread () calls in several different lo¬ 
cations, we decided to just write a 
macro and put it in one of our header 
files. That took care of the .be¬ 
gin thread 0 problem. 

Idefine ^beginthreadtw,x,z) _be- 
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ginthreadOf.^z) 

We make heavy use of the vari¬ 
able .threadid as an easy way to deter¬ 
mine the current thread ID. Watcom C 
defines this as; 

extern int *__threadid(void); 

•define .threadld L_threadid()) 

Our code would say something like: 

printfC'I am thread #5id\n\ *_threadid()); 

Under HighC, this failed miserably. It 
is defined as: 

extern int ,threadid; 

In this situation, it is best to make a 
separate function, which contains 
#ifdefs and compiler specific code, like 
this: 

int ThreadlO(void) 

{ 

•ifdef 

return{_threadid); 

•else 

return(*_threadid); 

tendif 

> 

printfC'I am thread #XdV, ThreadIDO); 

Because HighC seems to primarily 
a C++ compiler, it also is missing the 
mini) and maxt) macros* To be safe, 
make your own minO and max() func¬ 
tions: 

lifndef m 

•define MX(a,b) (((a) > (b)) ? (a) : 

(CM) 

iendif 
lifndef HIM 

idefine HHCa.b) (((a) < (b)) ? (a) : 
((b)) 

Iendif 

FINALLY, OS/2 FOR THE POWERPC! 

Finally Beta #2 of OS/2 for the 
PowerPC came out* We were excited. 
After installing the new build of the 
operating system we immediately 
went to work on our video system: a 
16-bit .DLL requiring the most work. 
Since we already had a 32-bit version 
of this .DLL (that took about a day to 
convert), it just was a matter of recom¬ 
piling under the new version of the 
compiler, writing a test program, and 
moving the files to the PowerPC. It 
was a success! The *DLL worked just 
as well as its 16-bit cousin. With this 
first success we were energized. We 
immediately went to work compiling 


the other .DLLs directly from the origi¬ 
nal Intel-based source code* Once 
again, success after success after suc¬ 
cess! In about eight hours, we had 
managed to compile all of our .DLLs 
and our main .EXE's for the PowerPC. 
Of course the big question still was, 
"Would it work?" 

Our software makes use of every¬ 
thing that is OS/2. We make extensive 
use of multithreading and sema¬ 
phores. We even wrote our own open, 
read, write, and close functions to by¬ 
pass the compilers and use nothing but 
32-bit calls. We were sure that we 


would find something that didn't 
work* 

THE BIG MOMENT 

Moving four megabytes of files to the 
PowerPC was easy. IBM has a basic 
TCP/IP stack that allowed us to use 
TFTP to move the files. Now the time 
had come for us to actually run our 
software* We typed Adept.Exe at the 
command prompt. Nothing. The screen 
blinked, the operating system returned 
an ambiguous return code, and we 
were back at the command prompt. 
Since we were not able to get the de- 
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bugger to work, we were dead and 
blind. Resorting to DosBeep, we fol¬ 
lowed the execution line of the code 
only to realize that we were missing a 
.DLL. Digging through our backups, 
we found the source, recompiled and 
moved the .DLL over to the PowerPC. 
Once again, at the command prompt: 

[C:\ADEPT\] Adept.Exe [ENTER] 

The screen blinked. We assumed, 
"Oh no, here we go again!" But no. A 
PM window was drawing on the 
screen—slowly—but it was drawing. 
After about 45 seconds, we were star¬ 
ing at our BBS software running on an 
IBM PowerPC! It worked! 

IBM had done it, we had done it! 

We played with the program to 
see if everything was working prop¬ 
erly. Amazingly, everything worked 
and ran flawlessly. In just 12 hours we 
were up and running with no prob¬ 
lems on IBM's OS/2 for the PowerPC. 

IBM wasn't kidding. When they 
originally promised that Workplace 
OS would have the same 32-bit API as 
OS/2 2.0 we may have all turned 
around and snickered a little bit, but 
with OS/2 for the PowerPC they really 
came through. 

Steven Tower is president and cofounder of 
AdeptSoft, a communications software devel¬ 
opment company based in Boca Raton, Fla. 
Tower is the strategic motivation behind the 
rewrite of XBBS-OS/2 from a 16-bit BBS pro¬ 
gram into AdeptXBBS, a pure 32-bit BBS pro¬ 
gram, for OS/2 on both the Intel and PowerPC 
platforms. AdeptSoft's development team is 
committed to the creation of innovative com¬ 
munication software that seamlessly integrates 
all aspects of Fidonet and Internet. Reach him 
at stower@adeptsoft.com. 

John Morris is senior VP/software engineer¬ 
ing at AdeptSoft. Morris is codeveloper of 
AdeptXBBS, a veteran Sysop and expert in 
communications software. Morris, a successful 
telecommunications shareware author for nine 
years, began BBS development by contributing 
code modifications and utililties for RBBS-PC, 
the first PC bulletin board software program. 
Morris was also lead developer of a popular 
on-line BBS game program, TradeWars 2. 
Morris has been running the same BBS IThe 
Abandoned Land) for 9 1/2 years, 365 days a 
year, 24 hours a day, or 83,220 hours total. 
Contact him at jmorris@adeptsoft.com. 


Adeptsoft can be contacted at 
sales@adeptsoft.com via email or 
our Support Board: 407-477-6310 
or Telnet adeptsoft.com 
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OS/2 for the PowerPC 


A veteran OS/2 application developer makes the trek from Intel to PowerPC. His results 
may surprise you. 

By RANDELLS. FLINT 

Getting There From 
Here: Moving to the 
PowerPC 


ow that OS/2 Warp Connect 
(PowerPC edition) is almost 
here, and you've heard about 
all the companies that are moving their 
applications over to this powerful new 
hardware platform, you've decided to 
move yours as well. There's no doubt 
that you've got an interesting task 
ahead. 

The great news, however, is that 
you're almost done already, provided 
you have a (pure) 32-bit native OS/2 
application. 

Of course the process is much more 
complex if you have a 16-bit applica¬ 
tion, or one that isn't OS/2 native. To 
get to the PowerPC from there, the first 
(and by far, biggest) step is in getting to 
32-bit native mode running on regular 
old OS/2 on an Intel-based system. But, 
that's not the focus of this article. 

What we're concentrating on is 
what you can expect in moving that ap¬ 
plication from the Intel-based OS/2 
world over to the new PowerPC-based 
OS/2 environment. At Sundial Systems, 
we've been working with OS/2 for 
PowerPC for over seven months. In that 
time, we've "moved" virtually all of the 
code for our Relish® time and informa¬ 
tion organizer products over to the 
PowerPC, What we presently have up 
and running is essentially a complete 
version of the single-user product. 
Relish 2.2. It looks, feels, and (for the 
most part) acts just like the commercial 
(Intel) version sold today. 

We've settled on the term "moved" 
to describe what we've done for good 
reason. Bringing a native OS/2 program 
onto the PowerPC isn't a porting 
process (like between operating sys¬ 
tems) or even a conversion process 


(which often describes the process of 
going from a 16-bit to 32-bit implemen¬ 
tation). It's something much simpler! 
It's very close to a recompile, relink, 
and go process. And getting closer 
every day as the operating system and 
tools reach their final release date. 

Things are a little rough today in 
those places where the OS/2 for 
PowerPC beta code hasn't completely 
settled down yet. (This discussion cen¬ 
ters around what is known as Beta II 
from April; a later beta should be avail¬ 
able before you read this article.) For in¬ 
stance, in the Beta II version, there's a 
quirky little bug in the allocation of 
shared memory, which means two 
Relish operations—dragging a note to 
reschedule and double-clicking on a 
note to revise—fail randomly about 20% 
of the time. 

And there's another weird problem 
shared by Relish, the System Editor, and 
a few other applications: the keyboard 
and mouse button state information 
messed up whenever the application 
first gets focus. 

There are a few other similar prob¬ 
lems and a bunch of little nit-picky 
ones. But all in all, even with these beta 
underpinnings, OS/2 for PowerPC has 
shown itself to share OS/2's heritage of 
a stable environment on which to build 
and deploy robust applications. Our lat¬ 
est prerelease of "Power Relish" is at 
least as stable and snappy as what some 
companies (mostly on other platforms) 
might be tempted to sell as a 1.0 prod¬ 
uct in the retail marketplace. 

In the process of getting to this 
point, we have made some changes to 
the code. Most are workarounds for 
current problems in a particular build 
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of OS/2 for PowerPC . A few are 
permanent changes to the code 
that replace an Intel-specific con¬ 
struct with one that works equally 
well on Intel and the PowerPC. 

The actual number of code 
changes is incredibly small, how¬ 
ever. Over the course of the past 
few months, the total number of 
changed lines of code has been 
down to as little as five—out of 
over 250,000! At the moment, that 
number is a little higher, as a re¬ 
sult of working around some Beta 
II problems to produce a version 
that is stable and complete enough 
to distribute to our beta test cus¬ 
tomers. Even at its highest point, 
however, the number of changes 
was almost two orders of magni¬ 
tude less than the number we 
needed to go from 16-bit to 32-bit 
OS/2 several years ago. 

To put it in a nutshell, we 
don't expect to do much more 
work on Power Relish before it 
ships. What we will do primarily 
involves "undoing" some of the 
things we've done already and 
performing extensive final testing. 
That "undoing" really amounts to 
the removal of the workaround 
code in the current (prerelease) 
version once there is a later OS/2 
for PowerPC version that fixes 
some of the problems mentioned 
above. There's an excellent chance 
we will be ready to ship before 
OS/2 for PowerPC becomes gen¬ 
erally available. 

And things are only getting 
better. Many of the early problems 
with the development tools have 
disappeared. Other improvements 
have been made so that you no 
longer need to know many of the 
special compiler flags or idiosyn¬ 
crasies of the linking process. It 
now seems quite likely that, had 
we started today rather than with 
the prebeta environment of last 
November, it would have taken 
only a couple of days, and certainly 
less than a week, to get Relish that 
far down the PowerPC path. 

The main reason why this 
whole process is so simple is that 
we are talking about OS/2. 
Whether it's running on Intel 
hardware or PowerPC hardware, 
the point is that it is OS/2. In the 
future, it will be "OS/2 and 
more," as the operating system 
(and the applications running on 
it) take further advantage of the 
PowerPC hardware. 
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Much of IBM's code that im¬ 
plements OS/2 as we know it 
today is the same on both Intel 
and the PowerPC. For instance, 
there are very few changes (and, 
possibly by now, none at all) in 
the code that implements the 
Workplace Shell. The differences, 
today, are in the "lower" parts of 
the system: the PowerPC version 
is based on IBM's microkernel, 
and sitting on top of that, a new 
OS/2 Server that implements all of 
the OS/2 calls (principally, the 
Dos* calls) in a way that is com¬ 
patible with the existing Intel 
implementation. 

Eventually, there will be even 
less of a difference. There will be 
one version of the entire OS/2 
source code tree—one based on 
the Microkernel and OS/2 
Server—that can be targeted to¬ 
ward either Intel or PowerPC 
hardware when it is built. 

Today, applications can al¬ 
ready be built that same way— 
with one set of source code, tar¬ 
geted for either Intel or PowerPC 
at build time. That's how we are 
building Relish. If you have trou¬ 
ble believing this, let me relay a 
story which you may have already 
heard about elsewhere since it is 
so remarkable. 

The folks at the Desktop 
Company have an OS/2 product 
called XFolder. This is an exten¬ 
sion to the Workplace Shell that 
supports all sorts of new arrange¬ 
ment and undo options for desk¬ 
top folders. It's extremely useful 
for keeping your icons neatly or¬ 
ganized. At some point in May, 
the company decided that it 
wanted to see if it could get 
XFolder up and running on OS/2 
for PowerPC—the IBM Technical 
Interchange was coming up and 
Desktop really wanted to show 
both versions. 

There was one little problem, 
though. The Desktop Company 
wasn't part of IBM's Beta program 
so it didn't have a PowerPC or a 
copy of OS/2 for PowerPC . It did 
have, however, the Beta toolkit off 
the Developer Connection CD 
(discussed later). The company 
tried to get XFolder compiled and 
linked, but ran into (what ap¬ 
peared to be) a compiler problem. 
So, when the people from Desktop 
Co. got to the Technical Inter¬ 
change, they hooked up with the 
folks from MetaWare (who sup¬ 
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plied the compiler) and got the 
issue resolved. (It turned out to be 
a mistaken use of a compiler 
switch.) Once they had a clean 
compile and link, they brought 
XFolder up on a PowerPC that 
MetaWare had at the show. 

Now this wasn't a truckload of 
code (only about 25,000 lines or so), 
but it wasn't simple code either. 
What we are talking about is a 
Workplace Shell replacement class, 
the corresponding objects, and a 
fair amount of user interface code 
to drive the thing. And it worked, 
for the most part, the first time out! 
The best part of the story is that the 
total development time involved 
was only about five hours. 

This brings us to a brief dis¬ 
cussion regarding how you are 
going to build your OS/2 for 
PowerPC application. 

Today, the basic strategy for 
actually building a PowerPC ap¬ 
plication is to build it on your 
Intel-based OS/2 system. While at 
some point in the future you will 
be able to build it on the PowerPC 
itself, using your Intel-based sys¬ 
tem today makes sense. That's be¬ 
cause OS/2 is a stable, robust de¬ 
velopment environment. So, since 
many developers already use it as 
a host environment for developing 
non-OS/2 applications, why not 
use it to develop PowerPC appli¬ 
cations as well? 

This Intel-hosted tools ap¬ 
proach has the added advantage 
of allowing development to pro¬ 
ceed at a faster pace than would 
otherwise be possible. And that's 
because you can develop an OS/2 
for PowerPC application com¬ 
pletely without even having a 
PowerPC (or PowerPC version of 
Warp). 

While it has gone almost un¬ 
noticed by many developers, all 
the tools necessary to build an 
OS/2 for PowerPC application 
have been appearing on IBM's 
Developer Connection (DEVCON) 
CD since Volume 6 in early 1995. 
Here's a brief overview of what 
you'll find: 

• A version of MetaWare's High 
C/C++ Compiler for OS/2. This 
is essentially the same compiler 
that you can buy to build OS/2 
for Intel applications, but this 
one has been modified to gener¬ 
ate PowerPC object modules 
rather than Intel object modules. 
In fact, this is the compiler that 


was used by IBM to build much 
of the Beta versions of OS/2 for 
PowerPC itself. (For those of 
you who just can't part with the 
idea of using IBM's CSet++ 
compiler, an Intel-hosted Pow¬ 
erPC version is also expected to 
be available soon.) 

* A replacement linker (also sup¬ 
plied by Meta Ware) that gener¬ 
ates PowerPC executables. 
These are in a new format 
specifically designed for the 
PowerPC. 

* Replacements for many of the 
supporting tools. MultiRes 
(MRES ) replaces RC, MuitiLib 
(MLIB) replaces LIB and IM- 
PLIB, and the Universal 
Resource Editor replaces the 
Dialog Editor, for example. In 
general, these new tools are de¬ 
signed for cross-platform use— 
they aren't PowerPC- or Intel- 
specific like the tools they 
replace. 

* A special version of IPMD that 
allows you to debug your 
PowerPC application over a 
TCP/IP-based LAN (but for 
that, of course, you need a 
PowerPC and you "need" bugs 
that need debugging). 

In all likelihood, your Power¬ 
PC application won't have any 
bugs! 1 can hear you saying, "This 
guy has lost his mind! All new ap¬ 
plications have bugs." Yes, it's true 
that newly programmed code al¬ 
most inevitably has bugs. But 
you're not dealing with new code 
here. 

If you have a working, de¬ 
bugged, native, 32-bit application 
running on OS/2 today, then once 
you get it recompiled and relinked 
into a PowerPC executable, it's 
quite possible you won't have any 
bugs to debug. And if you do, it's 
just as likely to be related to some 
quirk in OS/2 as it is to a quirk in 
your own code. 

What follows are some prob¬ 
lems that I've run into during my 
trip through the process. 

DOS* CALLS 

Because most of the Dos* calls in 
OS/2 for PowerPC have been re- 
implemented by the OS/2 Server 
and the Microkernel, this is the 
least "seasoned" part of the sys¬ 
tem. In a sense, this is the part of 
the system that will be the most 
1.0-like when it ships. It's the most 
likely part to have a few bugs or to 


at least operate a little differently 
than the present Intel version. It's 
also possible that some of the pa¬ 
rameter validation on these calls 
will end up being different. 

For instance. Relish happens 
to use the DosQueryCurrentDirectory 
call in one of those less than com¬ 
mon ways. What it does is pass 0 
for the size of the buffer that will 
be filled with the directory name. 
What OS/2 is supposed to do is re¬ 
turn an error code (ERROR_BUFFER_OVER- 
FLOW) together with the size of the 
necessary buffer. Well, in the ini¬ 
tial re-implementation of the Dos* 


calls, that didn't work, and the ini¬ 
tial testing of the re-implemented 
APIs didn't catch it. While the 
problem has since been corrected, 
it seems likely that a few of the 
more obscure corners of the Dos* 
calls may end up working not 
quite the same until your code 
happens to find the difference. 

THE NEW 32-BtT PORTABLE TOOLS 

Some of the tools you've com¬ 
monly used to build your applica¬ 
tions are being replaced by new, 
more portable versions. In the 
process, the new tools are often 
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supporting 32-bit constructs in 
place of older, 16-bit ones. For ex¬ 
ample, while resource identifiers 
used with RC have always been re¬ 
stricted to 16-bit values, MRES 
does its internal computations in 
32-bit form. Thus, if you used 
tricks with RC (like using -1 in¬ 
stead of 65535 as we did in a few 
places for historical reasons), youll 
need to make changes because the 
values won't come out the same 
with MRES. 


For instance, the MetaWare 
compiler caught a couple of places 
in some of our header files where 
there was a blank after the \ at the 
end of a line in what was sup¬ 
posed to be a continuation of a 
macro definition. What the com¬ 
piler did to that poor macro defini¬ 
tion wasn't a pretty sight—but it 
was right—the blank shouldn't 
have been there. CSet++ was just 
being overly kind to the definition 
in letting it through. 


CODE CHECKS 
MADE BY THE COMPILER 

Whenever you change compilers 
(or, for that matter, compiler ver¬ 
sions), you may also find that your 
source code gets treated just a bit 
differently than had been before. 
Some compilers are tighter about 
older or nonstandard code struc¬ 
tures than others. And some just 
have different interpretations of 
what is good and what is not, es¬ 
pecially in areas beyond the 
bounds of the language standard. 
This isn't a case where one com¬ 
piler is necessarily better than the 
other—they are just "different" in 
their approach to your code. 


NON-ANSI C EXTENSIONS 

While it's generally desirable to 
stay within the bounds of ANSI 
standard C, sometimes there is 
good reason to stray a bit. Adding 
threads to your program is a good 
example. If you try to do that 
within ANSI-standard C, it means 
using operating system calls (such 
as DosCreateThread) to control the 
threads. Once you take this ap¬ 
proach, however, you can't use a 
large number of your favorite C li¬ 
brary calls because either the li¬ 
braries aren't thread-safe or they 
require some sort of (non-ANSI) 
setup on a per-thread basis. So, the 
usual solution is to use nonstan¬ 


dard library calls (such as ,be- 
ginthread) rather than operating 
system calls for thread control. 
That's fine so long as the library 
calls are supported in the same 
way by the different compilers 
that you might use. But since, by 
definition, these calls aren't stan¬ 
dard, they might be different, or 
treated differently, and that's defi¬ 
nitely something you need to 
check. 

A perfect example is _be- 
ginthread. Even though it's part of 
both the CSet++ and MetaWare li¬ 
braries, the parameters to the call 
aren't quite the same. The CSet++ 
version takes four parameters, and 
MetaWare version takes three. 
Ironically, the parameters are the 
same except that CSet++ expects 
that its extra one (in the second 
position) be NULLS (For those of you 
who might not be familiar with it, 
CSet++ takes this extra parameter 
for historical reasons, which are 
related to how threads were han¬ 
dled on OS/2 Lx.) 

THE TOOLS ARE STILL EVOLVING 

Most compilers don't include all 
the non-ANSI part of their header 
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files, nor do they automatically in¬ 
clude non-ANSI libraries when 
used for linking. Usually, you in¬ 
clude something in the compile 
options to tell the compiler that's 
what you want to do. While the 
Meta Ware compiler includes many 
non-ANSI calls by default, that's 
not true for thread-related calls 
like .beginthread. 

In the early versions of the 
Meta Ware PowerPC compiler, you 
did this by defining ..MULTI., on 
the command line and changing 
your link options to reference the 
multithreaded library (hct.lib) ra¬ 
ther than the normal one (hc.lib). 
By the time Beta II arrived, this 
had been simplified through the 
use of the -thread compile option, 
which took care of both the header 
file and library issues. 

AVOID MAKING ASSUMPTIONS 

There are other non-ANSI issues 
that need to be dealt with in a sim¬ 
ilar way, one of which is SOM 
support. If you happen to use this 
in your code, you might think you 
should use the -som option in the 
same way you use the -thread op¬ 
tion. Well, that's not quite right. 


because when compiling , this turns 
on Meta Ware's support for Direct- 
To-SOM code generation, which is 
probably not what you want in 
this case. However, you probably 
do want the -som option when link¬ 
ing , since this will cause any neces¬ 
sary SOM libraries to be linked in. 

LIBRARIES YOU NEED 
MAY NOT BE AVAILABLE 

One particularly vexing problem 
in these early stages of movement 
to the PowerPC is the availability 
of any third-party libraries that 
you might need as part of your 
application. 

The good news is that libraries 
move over just as easily as appli¬ 
cations do. The bad news is that 
you need the source code to do it 
(or you have to have the owners of 
the source code do it). In Relish, 
we do use one third-party library. 
Fortunately, we do license the 
source code and have moved it 
over using the same process as our 
own source. 

SOME DIFFERENCES IN THE 
UNDERLYING IMPLEMENTATIONS 

And, finally, once you do get the 


code compiled, linked, and run¬ 
ning on the PowerPC you may 
still notice some minor differences 
that shouldn't (but might) make a 
difference. That's because parts of 
the operating system are indeed 
different. 

In Relish, we happened to no¬ 
tice this in the case of critical sec¬ 
tions. While it's probably not no¬ 
ticeable to the user, we discovered 
that entering and exiting critical 
sections is a little more costly on the 
PowerPC than it is on the Intel ver¬ 
sion of OS/2. Sources tell us that 
it's true, and the reason has to do 
with how the OS/2 Server inter¬ 
faces with the Microkernel to im¬ 
plement (jointly) the DosEnterCritSec 
and DosExitCritSec calls. Likewise, 
there are other calls which seem a 
little faster on the PowerPC, 
though this may have as much to 
do with the processor as anything 
else. 

So if you've got any really 
tight timing dependencies, partic¬ 
ularly among multiple threads, 
you might want to test that code a 
little extra carefully. 

Another area of major differ¬ 
ences is in the device drivers. IBM 
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hasn't publicly said so, but it ap¬ 
pears that much (if not all) of the 
device driver code is brand new 
in the PowerPC version* In part, 
that's to be expected, since the 
low-level hardware architecture of 
the systems is indeed different. 
While the various OS/2 APIs hide 
most of these issues, some of the 
differences will no doubt surface 
through them* In particular, appli¬ 
cations that deal intimately with 
devices (such as communications 
programs) would appear to re¬ 
quire particular scrutiny in their 
use of these APIs* 


CONCLUSION 

All in all, it's fairly easy to move 
your application onto OS/2 for 
PowerPC. Start with your 32-bit 
native OS/2 application, keeping 
in mind that OS/2 for PowerPC 
and the tools you need are still 
beta in nature; and, don't be sur¬ 
prised by the inevitable quirks 
that might put bumps in your 
path. Then, head out on this pow¬ 
erful new hardware platform. 
You'll likely enjoy this trip much 
more than porting or conversion 
efforts you've been on in the past* 
And, if you'd like to get a feel 


of just how close things can get, 
we'll be happy to send you 
Working Model (demo version) 
copies of Relish for both Intel and 
PowerPC. That way you can re¬ 
ally compare and see for yourself. 

You can download both ver¬ 
sions from a variety of sources (in¬ 
cluding the SundiaT Systems sup¬ 
port section in -the OS2AVEN 
forum on CompuServe). Or, if you 
prefer, we'll send you copies on 
diskette. For the latest availability 
information, just drop us a note 
via the Internet to relish@ibm.net* 


Now, this is a genuine 
Rocky Mountain "Hi!" 
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Database Development 



An OS/2 software developer meets airline industry requirements with a low-cost, 
dient-/server-based reservation system. 

By JIM MONROE 


Building an 
OS/2-Based Airline 
Reservation System 


ince the advent of the PC, software 
designers have been faced with 
many choices: operating systems, 
database engines, programming languages, 
and other application requirements. This arti¬ 
cle is about the approach taken and some de¬ 
cisions made in the development of an all- 
new, client-/ server-based airline reservation 
system* This development approach may pro¬ 
vide some help when, and if, you are faced 
with a similar predicament. 

BACKGROUND 

Prior to embarkation into the airline industry, 
many months were spent analyzing the in¬ 
dustry and the application offerings available. 
The findings were that the industry is ex¬ 
tremely narrow and, to survive, any products 
offered would have to be inexpensive and use 
the best technology available, 

SETTING SOME GOALS 

An airline reservation system was produced 
that was scalable to serve the needs of a very 
small budget airline all the way up to the size 
of currently available large reservation sys¬ 
tems. The system would be priced 50% lower 
than competitive systems and would still earn 
a profit. 

The design criteria consisted of the fol¬ 
lowing elements: 

• It would be scalable from a single PC to an 
IBM 370/390 system 

* It would use an "Open Architecture" 

* All data would be available from a rela¬ 
tional database 

* The operating system would support mul¬ 
titasking and multiple users 

• A response time of less than two seconds 
would be maintained at all times 

• Networking would be easy to install, main¬ 
tain, use, and include the ability to connect 
via the Internet 


* It would be accessible from any terminal 
type, internal or external to the enterprise 

* The system would be easy to use and re¬ 
quire little or no training. 

A descriptive name was selected that 
would also convey simplicity: The Airline 
Reservation System (TARS). With TARS, sev¬ 
eral potential customer groups are addressed: 

* Start-up airlines with a choice of terminal 
types and physical placement because they 
have nothing installed—no heritage 

* Airlines that have already migrated their 
reservation center, airport counters, and 
agents to PCs because they have been 
migrating to LAN-based distributed 
processing 

■ Airlines that have not migrated (or have 

been delayed) to a PC "terminal" strategy 
because their installed base or wiring im¬ 
paired migration 

* Airlines that are "renting" services, which 
preclude flexibility or ultimate use of na¬ 
tive PC technology because someone else is 
dictating the connectivity alternatives 

■ Airlines with significant investment into 
wiring that cannot be easily accommodated 
into certain terminal connectivity because 
they have stayed with the early VT termi¬ 
nal dusters. 

SEEKING A MULTI USER, MULTITASKING, 

MUL TtPLA TFORM SOLUTION 

To provide needed scalability, the architec¬ 
ture was designed as a distributed application 
within a client/server environment. This 
would allow the relational database to reside 
on either the server or on a client system. 
After reviewing several database engines that 
met this requirement, IBM's DB2 became the 
logical choice. One reason was because this 
engine could be used on OS/2, AIX/UNIX, 
OS/400, MVS, VSE, VM, Sun Solaris, or HP- 
UX* This covered all possible system combi- 
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nations, allowing TARS to be operating sys¬ 
tem- and hardware-independent. 

C was chosen as the programming lan¬ 
guage because it also supported all operating 
system and hardware platforms. Also, C pro¬ 
grammers are available and the language is 
not manufacturer dependent. 

OS/2 WARP—ON SERVERS AND CLIENTS 

At the low- to mid-range level, OS/2 Warp 
was used for both server and client. By in¬ 
stalling DB/2 on this platform, the smallest 
configuration fits on a single personal com¬ 
puter. By propagating DB/2 to larger or mul¬ 
tiple-user platforms, and keeping the client 
portion on OS/2, the system can grow to any 
size needed. This also included the ability to 
attach any noninteUigent terminal directly via 
RS232, over TCP/IP or the Internet. 

When examining various networking re¬ 
quirements, it was found that the IBM LAN 
support (LAN Server version 2,X and later) 
addressed the traditional client/server re¬ 
quirements, as well as wide-area networks 
(WAN), It also allowed noninteUigent termi¬ 
nals to be run off the servers, eliminating the 
need for some dedicated PC clients. The abil¬ 
ity to have clients either local or remote to the 
server was possible Complete interoperability 
of the system was maintained by the DB2 
client/server support. 


ADDING TERMINAL 
SUPPORT TO OS/2 WARP 

The last portion of the architec¬ 
ture was the terminal server, 
which connected the central 
database clients to the airports. 
The airports provided reserva¬ 
tion terminals at the check-in 
counters and departure gates. 
As such, the imposing routers 
and gateways would make the 
solution expensive and man¬ 
agement-intensive. A multi¬ 
user system eliminated this 
problem because the multi- 
user cluster could be located 
either at the Reservation 
Center or at the airport. In ad¬ 
dition, remote printing of tick¬ 
ets and reports would be avail¬ 
able at both the check-in and 
departure gates. 

The decision was made to 
use a currently available prod¬ 
uct, REMOTE-OS, instead of 


writing the terminal support in-house. This 
decision was based on REMOTE-OS's ability 
to provide both the terminal support as well 
as the required network connectivity. 

PERFORMANCE TUNING 

Stored procedures were used to reduce the in¬ 
teraction between the client and server. This 
alone resulted in an approximate 50% reduc¬ 
tion in communication between the two. To 
improve performance, only static SQL state¬ 
ments were used (as opposed to dynamically 
executed statements). Sorting and ordering 
were held to a minimum to reduce execution 
time. (When DB2 resides on the OS/2 system, 
as much real storage as possible is made 
available.) These steps resulted in a system 
that provided a predictable performance that 
was within our design criteria. 

BUILDING THE FRONT END 

TARS provides a friendly user interface in¬ 
cluding action bars, pull-downs, message 
windows, and parallel dialogues such as on¬ 
line contextual help (Figure 1), The operator 
interface is self-prompting, self-educating, 
and provides examples of allowable data for 
entry. Each operation consistently follows the 
same steps each time, OS/2 Warp's 
Presentation Manager was not used since that 
would limit remote terminals to intelligent PC 
systems and drive up our costs. 

DB2 provides the ability to query the 
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database via menu-driven forms, speci¬ 
fying data fields, logical relationships, 
and sequences* An example of a fixed 
"query" is a passenger who calls with 
questions about a reservation but does¬ 
n't remember the confirmation number. 
The operator can enter the passenger's 
last name, or a smaller subset of the 
name, on the panel The result is a view 
of similar names with home and office 
phone numbers, where the operator, 
prompted by the passenger, scrolls to 
the correct reservation. At this point, 
the system displays the outbound and 
inbound flights for the passenger, and 
the selection continues until the passen¬ 
ger is fully serviced. 

When a graphical interface to DB2 
becomes a requirement—because the 
terminals are GUI capable—the GUI- 
WYSIWYG look and feel can be added 
using IBM's GUI DB2 tools, without 
changing any code in TARS itself. In 
addition, DB2 provides an export/im¬ 
port function to most spreadsheet or 
word-processing applications, so the 
customer is still not obligated to "our 
way of thinking." Further, DB/2 pro¬ 
vides the necessary data security and 
data integrity support, an absolute re¬ 
quirement for an airline reservation 
system. 

A CLIENT/SERVER AIRLINES 
RESERVATION SYSTEM 

The TARS project achieved the goal of 
providing the airlines with an afford¬ 
able alternative for a reservation sys¬ 
tem, while still providing the function 
of larger systems. The self-training user 
interface lets an airline hire agents unfa¬ 
miliar with airline industry jargon and 
spend less than a day training them. 
This alone more than justifies the sys¬ 
tem in the eyes of airline management, 
saving several weeks for each counter 
or reservation person. 

The DB/2 database provides com¬ 
prehensive reporting on a real-time 
basis. This allows management to make 
decisions immediately, rather than 
waiting until tomorrow for a report, 
TARS is completely configurable, on a 
real-time basis, and flights can be cre¬ 
ated, edited, and rearranged as needed. 
This would be impossible without a re¬ 
lational database. 

TARS can be connected with other 
reservation systems used by indepen¬ 
dent travel agents. Reservations are 
simply downloaded into TARS once the 
local PC has polled the other reserva¬ 
tion system(s) and extracted all reserva¬ 
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tions made by the independent agents. 

TARS has been installed at several 
airlines and has proven to be successful 
and the design criteria realized. 

The growth of OS/2 Warp, DB/2, 
and C functionality should pave the 
way for future enhancements that are 
not previously available to small air¬ 
lines, such as adding voice response ca¬ 
pability to TARS, From an application 
development point of view, software 
designers are positioned to take advan¬ 
tage of hardware and software progress 
without having to wait. 

The nicest part about this project 
was that once the tools were selected, 
the focus went to application develop¬ 
ment. OS/2 provided the multitasking, 
multithreading environment. LAN 
Server provided the peer-to-peer and 
PC support. DB2/2 provided the en¬ 
gine and support for the structured and 
unstructured queries for an endless va¬ 
riety of reports. Finally, REMOTE-OS 
provided the local and remote access to 
PCs and terminals, eliminating a lot of 
low-level programming. 

Jim Monroe was employed by IBM for 30 
years until 1389 . Since then, he has developed 
various OS/2- and DB2/2-based applications 
for the retail and airline industries. He can be 
reached at 407-361-0109 fax 407-361-9851 or 
via CompuServe at 74230,2407 f . 
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Objects 

Using OpenDoc as a multiplatform "killer" application framework, 

By ROBERT C. YEAGER 


OpenDoc-More 
Than Just Documents 


r he forthcoming OpenDoc technol¬ 
ogy, jointly developed by IBM, 
Apple, and WordPerfect, is cur¬ 
rently promoted as an open-architectured 
compound document technology in current 
literature. This description provides ample 
ammunition for authors to compare and con¬ 
trast OpenDoc and its chief competitor, 
Microsoft's OLE (Object Linking and 
Embedding). This viewpoint has been pro¬ 
moted to provide developers and users with 
a clear product identity against the competi¬ 
tion, Currently, much ink is being spilled in 
comparing and contrasting OpenDoc and 
OLE as compound document editors. 

This is unfortunate because OpenDoc 
has a deeper and more subtle technical foun¬ 
dation than the description "compound doc¬ 
ument editor" implies. What OpenDoc really 
represents to software developers is a plat¬ 


form-independent, language-independent 
application framework. 

Much of OpenDoc's capabilities are di¬ 
rectly attributed to the use of IBM's System 
Object Model (SOM) in implementing 
OpenDoc. After some early growing pains, 
SOM has now matured enough to be ready 
for prime time. SOM is a proven, reliable 
technology, as demonstrated by OS/2'* 
Workplace Shell. After lurking under the 
hood of OS/2 for two years, SOM is ready 
for the spotlight as OpenDoc is unveiled 

The purpose of this article is to present a 
view of OpenDoc as a prebuilt multiplatform 
application framework for developers. This 
viewpoint avoids the abstract document-eon- 
tainer-part terminology usually associated 
with OpenDoc in favor of framework-class- 
subclass terminology. Framework-class-sub¬ 
class terminology is used in formal object- 
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provided and 
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Create or purchase 
platform-specific faucets 


Figure 1 . The OpenDoc plumbing system. 
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oriented design methodologies such as the 
Booch method. Hopefully, this will allow 
you to break the association of OpenDoc 
with documents and concentrate on 
OpenDoc as an object-oriented development 
platform, which may be used to develop any 
type of application* 

We will start off by first examining 
early frameworks and the limitations in 
their use. I'll then introduce SOM technol¬ 
ogy, showing how it alleviates the prior 
shortcomings of frameworks. A general 
overview of the OpenDoc framework design 
will liken the OpenDoc framework to a 
plumbing system complete with pipes, 
faucets, and caps. Finally, a short OpenDoc 
sample subclass will be developed to 
demonstrate the ease of writing a new 
OpenDoc application. The sample will port 
the DIVE (Direct Interface Video Extensions) 
sample program from the OS/2 Multimedia 
Toolkit to OpenDoc* So prepare to DIVE 
into OpenDoc! 

VANILLA FRAMEWORKS 

Frameworks are best described as cooperat¬ 
ing object-oriented classes, which when used 
collectively provide a working piece of func¬ 
tionality. For example, the IBM C++ User 
Interface classes form a framework that col¬ 
lectively provides an object-oriented pro¬ 
gramming interface to access the OS/2 
Presentation Manager APIs. Many types of 
frameworks currently exist to solve common 
problems. A Collection framework provides 
access to arrays, linked lists, and queue 
structures, while Persistence frameworks 
allow objects to save their current state to 
permanent storage (that is, save data to 
disk). 

Frameworks take advantage of previ¬ 
ously written and debugged code and allow 
framework users easy access to that working 
functionality. As an added bonus, frame¬ 
work users are able to extend the frame¬ 
work's functionality by subclassing frame¬ 
work classes. Subclassing a framework class 
allows the developer to inherit all the func¬ 
tionality of the base class and add new func¬ 
tionality, as well as remove or replace exist¬ 
ing functionality. 

The ability to add, remove, or correct 
framework functionality makes them very 
flexible in solving development problems. 
Adding functionality to a framework is criti¬ 
cal to promoting code reuse* Removing exist¬ 
ing framework functionality is a prerequisite 


to replacing functionality so as to correct 
framework bugs or to optimize performance. 

The power of frameworks to date has 
been limited to providing developers with 
existing functionality wrapped externally 
with object-oriented classes. User Interface 
frameworks. Collection frameworks, and 
Persistence frameworks functionally provide 


tifndef _DIVEPART_ 

(define .DIVEPART. 

/* Include parent's definition 

*/ 

(include <SiwpQPrt,idl> 

/* DIVEPart is descended from 

*/ 


/* SimplePart 

♦/ 

interface DIYEPart : S.unplePart 
{ 

/* This new method will update 

*/ 


/* the visible facets onscreen 

*/ 

void UpdateFacets(in ODFacet facet); 

/* SOU-specific section 

*/ 

iifdef „SOOL„ 
implementation 

/* Define a prefix for methods 

*/ 

functionprefi* ~ DIVEPart; 

/* Define the release order to 

*/ 


/* preserve backwards binary 

•/ 


/* compatibility 

*/ 

releaseorder: UpdateFaeets; 

/* Select methods to override 

*/ 


/* from the ancestor classes 

*/ 

override: 

sonilnit, 
soisUninit, 

F a c et A dd ed, 

FacetRemoved, 

GeometryChanged, 



HandleEvent, 

InitPart, 

JhitPa rtF romSto rage, 
IctivateFrame, 

Focustcquired, 

FocusLost, 

ktivatinglfindow* 

Draw; 

/* Ue will need an ordered 

*/ 


/* collection to contain all 

*/ 


/* visible facets 

*/ 

passthru C,*ib = "class ODxQrderedtollection;"; 



/♦ Define an instance variable 

*/ 

Qlh 0 rderedCollection *Facets; 



ft 

lendif 

h 

tendif 




Listing 1, A new IDL source file that describes a new class. 
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nothing new. Their power lies in mak¬ 
ing functionality easy to use and to ex¬ 
tend. By themselves, frameworks 
haven't made the chore of writing an 
entire application much easier. 

Frameworks also have had severe 
limitations in their use. In the past, 
frameworks could only be used from 
the programming language, which 
used to develop the framework itself. 
A framework written in C++ was use- 
less to a Smalltalk developer and vice 
versa. Also, different language compil¬ 
ers were even incompatible, most no¬ 
tably with C++, This incompatibility of 
frameworks isolated them from the in¬ 
creasingly heterogeneous client-server 
solutions of today and was a limitation 
on promoting business-wide code 
reuse. 

Another limitation in using frame¬ 
works occurred when the framework 
needed to be updated or corrected. 
Updating the framework would re¬ 
quire all clients using the framework 
to be recompiled because the frame¬ 
work didn't preserve backwards bi¬ 
nary compatibility. This synchroniza¬ 
tion dilemma made frameworks 
cumbersome to maintain and update, 

SOM FRAMEWORKS 

SOM technology breaks down the ear¬ 
lier barriers to object-oriented frame¬ 
works, SOM is not a programming lan¬ 
guage but rather an object packaging 
technology, SOM is much more com¬ 
prehensive than the short discussion I 
will present here, which will serve 
only to demonstrate a portion of its ca¬ 
pabilities in correcting the prior short¬ 
comings of frameworks, 

SOM allows frameworks to be 
used by any programming language 
that has SOM bindings available. 
Currently, SOM bindings exist for C, 
C++, Smalltalk, and ObjectREXX, 
COBOL bindings have been indicated 
to be forthcoming shortly. As you can 
see, even procedural (nonobject-ori- 
ented) languages such as C, COBOL, 
and REXX can use frameworks using 
SOM technology. 

SOM also preserves backwards bi¬ 
nary compatibility, so that when a 
framework is updated the client pro¬ 
grams don't have to be recompiled. 
Backwards binary compatibility makes 
it feasible to package frameworks as 
shareable binary DLLs, which is ex¬ 
actly how the OS/2 Workplace Shell is 
distributed, 

THE OPENOOC PLUMBING SYSTEM 

OpenDoc has the technology to revo¬ 
lutionize the software development 



Listing 2. A completed program. (Continued on page 41.) 


40 


OS/2 DEVELOPER 






Listing 2 r A completed program. (Continued on page 42 } 


process. This is because OpenDoc is a 
platform-independent, language-inde¬ 
pendent application framework* 
OpenDoc's power comes from the 
usage of IBM's SOM technology to im¬ 
plement OpenDoc. 

SOM provides OpenDoc with lan¬ 
guage-independence, but by itself 
doesn't ensure platform independence. 
Only the careful design of the 
OpenDoc framework provides this fea¬ 
ture. OpenDoc essentially provides a 
complete plumbing system for an ap¬ 
plication, Figure 1 depicts a portion of 
the OpenDoc design. Whenever Open¬ 
Doc can provide a service that can be 
implemented across platforms, such as 
graphical clipping algorithms, it pro¬ 
vides a working faucet that a devel¬ 
oper can immediately unscrew. When 
OpenDoc runs into platform-depen- 
dent service, such as the actual draw¬ 
ing commands for a graphical object, it 
carefully caps off the pipe in such a 
way that a developer can easily fit a 
faucet of his/her choosing* OpenDoc 
part development tools will provide a 
means for designing these platform- 
specific faucets. 

The OpenDoc plumbing system is 
extendible. This can be accomplished 
by purchasing or designing new 
faucets {such as three-dimensional pie 
charts or multimedia parts) or by pur¬ 
chasing or designing new extensions or 
modifications to the OpenDoc plumb¬ 
ing system, complete with faucets 
(word processors, spreadsheets). 

Even though OpenDoc provides 
the complete plumbing of an applica¬ 
tion, this doesn't require that all appli¬ 
cations have the same look and feel. 
This is because OpenDoc's root part 
(the document shell) can be replaced at 
startup* This gives developers the op¬ 
portunity to create their own shell, 
customizing it as needed* Creating a 
shell doesn't require writing one from 
scratch—you can simply override the 
behaviors of the existing shell that you 
want to modify. 



DIVING INTO OPENDOC 

"Yeah, great—so what?" you may ask* 
The implications of OpenDoc cannot 
really be appreciated until you have 
developed an OpenDoc application. 
OpenDoc provides an entire working 
application wrapped in an elegant 
SOM framework, which is portable 
across multiple platforms and can be 
developed with multiple languages! 
To demonstrate the advantages ac¬ 
quired with OpenDoc, we will take an 
existing program and convert it to 
OpenDoc. 
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Without going into much detail, 
Direct Interface Video Extensions 
(DIVE) is a multimedia subsystem 
that provides direct access to video 
hardware* The DIVE APIs automati¬ 
cally detect and use video accelerator 
hardware to provide extremely fast 
video updates suitable for games and 
animation. 

The DIVE sample that we will con¬ 
vert to Open Doc can be found in the 
OS/2 Warp Developer Toolkit on the 
Developer Connection CD-ROM vol¬ 
ume #7, (We will not reproduce the 
original source code here for brevity.) 
The converted program will require the 
OpenDoc Developer Tool-kit, OS/2 
Warp Developer Toolkit, and the OS/2 
Warp Fixpack #5—all on the Developer 
Connection CD-ROM volume #7, 

The first step in developing for 
OpenDoc is to choose an appropriate 
class to subclass. This allows you to 
inherit behaviors (code) free of 
charge. Because this will be a minimal 
conversion to OpenDoc, I have se¬ 
lected the Simple class from which to 
start. As you develop in OpenDoc, 
you can reuse your existing code 
through subclassing. 

To hook into OpenDoc, you must 
first use the SOM compiler to create 
your new class. This involves writing 
an IDL (Interface Definition Language) 
source file, which describes your new 
class. Remember that SOM is language 
neutral—the IDL is the key to this neu¬ 
trality, IDL is nothing more than a 
class-definition language. 

Our IDL, for this example, is 
shown in Listing 1. It defines our new 
class, DIVEPart, and the methods of the 
parent class which to override. The 
critical overrides are the FacetAdded, 
FacetRemoved, GeometryChanged, and Draw 
methods, which will process the em¬ 
bedding, removal, and drawing of the 
DIVE part. 

After writing the IDL definition, 
invoke the SOM compiler to generate a 
stub file and supporting headers* The 
stub file contains the entry points for 
new methods and overrides. At first, 
every entry point will be either empty 
for new methods or contain a call to 
the parent method for overrides* 

If we were to compile the pro¬ 
gram without modifying the C++ 
source file, the resulting program 
would function exactly as the parent 
Simple class. You would also find that 
the resulting size of the DLL would be 
small. This is the magic of inheritance. 

Listing 2 shows the completed 
program with the DIVE components 
embedded in the appropriate over- 
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if (Div eQ ue ryCaps(ftDiveCaps, DTVE_BU FfER_SCREEN)) 

{ 

YinflessageBox (HMDJESKTOP * HYHD.DESKTOP, 

"The sample program can not run on this system \ 

environment.% 


h DlVE Sample", 0, KB.CK I HB.IWFDRHATIOH); 
free(puinData); 
return; 

} 


if (DiveCaps.ulBepth < 8} 

{ 

WinflessageBox (HWND^DESKTOP, HtfND.OESKTOP, 

"The sample program can not run on this system \ 

environment*”, 


"DIVE Sample", 0, HBJK f MB.INFQRNATIDN); 
free(piunData); 
return; 


} 


if (DiveOpen{|[(pvirData->hDive) 1 FALSE, 0)) 
{ 


Win He s sageBox (H iND.DESKTDP, MNO.DESKTQP, 

"The sample program can not run on this system 


environment/, 


"DIVE Sample", 0, NBJK ] flB^FORHATION); 
free(pwinOata); 
return; 


} 


\ 


for (i * 0, pwinData->ulflaxFiles = 0; i < HU.FUE; i ++ ) 
{ 

if (Read Filed, pszOefFile[i], pwinOata)) 

{ 

lOnWessageBox (HU NO .DESKTOP, MHO .DESKTOP, 

"Failed to open bitmaps/, 
"Error!", 0, WBJK | HB/QVEA8LE); 

} 

else 

pwinData->ulRa * Files**; 

> 


MinRegisterdassthab, "DiveWindow", HyWindowProc, CS.R0VEN0TIR, 
sizeof(ULONG)); 


p uinData-> h w ndF rame * YinCreatetfindowthundFacet, "DiveWindov", NULL, 

WS VISIBLE I YS.SVNCPAINT, 

0, 0, 0, 0, 

hwndFacet, BWNDJOP, 0, 0, 0); 


pwinOata->hwndQient = pwin Data->hwndFr arise; 

WinSetWindovULong {piiinData->hyndClient, 0, <UtOHG)pwioData>; 

pwinData->cxWidthYindov 3 puinData->ulWidth; 
pwinData->cyHeightYindow = pwinData->ulH&ight; 

pwinData->fChgSrcPaIette = FALSE; 

WinPostRsg{pvinData->hwndFrame p WM JRHEHABLED, OL, OL); 

if (DosCr eateTh read(A(pwinData->tidBlitTh read), 

(PFNTHREAD) DirectNoveHem, 
(ULQNG)pwinData, OL, 8192L)) 

{ 

WinSetVisiblefiegionBotify CpwinData->hwndQient, FALSE); 

for <1 = 0; 1 < pwinData->uU^axFiles; i++) 

DiveFreelmageBuffer(pwinData->hDiv e, ullmage[il); 

DiveCLoseCpwinData->hDive}; 

Win De stroy Window(pwinData->hw nd Frame); 

free(pwinDate); 

return; 

} 


Listing Z A completed program. (Continued on page 43.) 
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> 


DosSetPriority(PRTYS.THREAD, PRTYC.IDLETME, 0, pwinData-HidBlitTtiread); 

/♦Save the created DIVE window ♦/ 
/♦ handle in the part's info */ 

facet->SetPartInfo(ev, (ODInfoType)(pwinData->hwndFrame)); 

/♦ Force a repaint of the part ♦/ 

somSelf->GeometryChanged(ev, facet); 

> 


/♦ This method is called when ♦/ 
/♦ the user either deleted the */ 
/* part or closes the shell */ 
SOM.Scope void SOMLINK DIVEPartFacetRemoved(DIVEPart ♦somSelf, 

Environment *ev, 

OOFacet* facet) 

DIVEPartData *somThis * DIVEPartGetData(somSelf); 
DIVEPartMethodDebugCDIVEPart", "DIVEPartFacetRemoved"); 


/♦ Remove the facet from the 
/♦ ordered collection 


♦/ 

♦/ 


if (_Facets->Contains(facet)) 
_Facets->Remove(facet); 


HWND hwndDIVE * (HWND)facet->GetPartInfo(ev); 

PWINDATA pwinData = (PWINDATA)WinQueryWindowULong(hwndDIVE, 0); 


if (hwndDIVE AA pwinData) 

{ 


int i; 


/♦ ALL THE FOLLOWING CODE IS ♦/ 
/♦ FROM THE DIVE SAMPLE — SEE ♦/ 
/♦ THE SAMPLE CODE FOR COMMENTS */ 


ulToEnd * 1; 

DosWaitThread(A(pwinData->tidBlitThread), DCWW.WAIT); 

for (i * 0; i < pwinData->ulMaxFiles; i*+) 

DiveFreelmageBuffer ( pwinData->hDive, ullmage[i] ); 

DiveQose(pwinData->hDive); 

if (pwinData->fccColorFormat ** F0URCC.LUT8) 

{ 

for (i * 0; i < pwinData->ulAaxFiles; i*+) 

DosFreeMem(pPalette[i]); 

> 

free(pwinData); 

HinDestroyWindow(hwndDIVE); 

} 

DIVEPart_parent_SimplePart_FacetRemoved(somSelf, ev, facet); 

} 

/♦ Invoked when the shape of */ 
/* the part changes */ 

SOM.Scope void SONLINK DIVEPartGeometryChanged(DIVEPart ♦somSelf, 

Environment *ev, 

ODFacet* facet) 

{ 

ODRect rect; 

DIVEPartData ♦somThis = DIVEPartGetData(somSelf); 
DIVEPartMethodDebugCDIVEPart","DIVEPartGeometryChanged"); 

/* Retrieve DIVE window handle */ 
HWND hwndDIVE « (HWND)facet->GetPartInfo(ev); 
if (hwndDIVE) 

{ 

MATRIXLF mtx; 

ODTransform* transform * facet->GetFrameTransform(ev); 

/* Ensure we can display the */ 
/* window ♦/ 

transform->GetMATRIXLF(ev, Amtx); 

if (mtx.fxM12 « 0 AA mtx.fxM21 == 0 AA mtx.fxMU > 0 AA mtx.fxN22 > 0) 

{ 

/♦ Transform OpenDoc coords to */ 


Listing 2. A completed program. (Continued on page 44.) 
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/* OS/2 PH coords ♦/ 

facet->GetFrame(ev)->GetFrameShape(ev)->GetBoundingBox(ev, irect); 
ODPoint botLeft ■ {rect.left, rect.bottom}, 
topRight a {rect.right, rect.top); 

bottomLeft.x = rect.left; 
bottomLeft.y * rect.bottom; 
upperRight.x « rect.right; 
upperRight.y s rect.top; 

botLeft * transform->TransformPoint(ev, ibotLeft); 
topRight = transform->TransformPoint(ev, fttopRight); 

/* Position the DIVE window */ 

VinSet¥indowPos(hwndDIVE, 0, 

FIXED2L0NG(botLeft.x), 

FIXED2L0NG(botLeft. y), 

FIXED2L0NG(topRight.x - botLeft.x), 

FIXED2L0NG(topRight.y - botLeft.y), 

SWP.HOVE I SWP.SIZE); 

/* Calculate the clip region */ 
ODShape* clipShape s facet->GetAggregateOipShape(ev)->Copy(ev); 
dipShape->Transform(ev, facet->Get¥indowFrameTransform(ev)); 
ODTransform* offset * new ODTransform; 
botLeft.x * -botLeft.x; 
botLeft.y c -botLeft.y; 

offset->SetOffset(ev, ftbotLeft); 
clipShape->Transform(ev, offset); 

/* Clip the DIVE window ♦/ 

WinSetCL±pRegion(hwndDIVE, clipShape->GetRegion(ev)); 
delete clipShape; 

WinShowWindow(hwndOIVE, TRUE); 

MinPostHsg (hwndOIVE, WH.VRNENABLED, OL, OL ); 

> 

else 

{ 

WinShowWindow(hwndOIVE, FALSE); 

} 

> 

/* Invoked for user-initiated ♦/ 

/* events */ 

SOH Scope OOBoolean SOHLINK DIVEPartHandleEvent(DIVEPart *somSelf, 

Environment *ev, 

OOEventData* event, 

OOFrame* frame, 

ODFacet* facet) 

DIVEPartData ♦somThis = DIVEPartGetData(somSelf); 

DIVEPartHethodDebug( M DIVEPart","OIVEPartHandleEvent"); 

/* Set the focus to the DIVE */ 

/* window if requested */ 

if (facet && event->hwnd ** facet->GetFacetHWND(ev)) 

if (event->msg M UH.SETFOCUSWIN) 

WinSetFocus(HWND_DESKTOP, (HWND)event->mpl); 

> 


return (DIVEPart.parent.SimplePart.HandleEvent(somSelf, ev, 

event, frame, 
facet)); 

^ /* Invoked when part needs to ♦/ 

/* be initialized */ 

SOH.Scope void SOHLINK DIVEPartInitPart(OIVEPart ♦somSelf, 

Environment *ev, 

ODStorageUnit^ storageUnit) 

DIVEPartData *so«This * OIVEPartGetOata(somSelf); 

DIVEPartHethodDebug("OIVEPart","DIVEPartlnitPart"); 

/* Only initialize once */ 

if (somSelf->IsInitialized(ev)) 
return; 


Listing 2. A completed program. (Continued on page 45.) 
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s omSelf->IiutPe rsistentDbject(ev, storageUnit); 

/* Create the ordered collection*/ 

/* to hold facets */ 

Facets = new ODiOrderedCollection; 

> 

/* Called when the document is */ 

fa loaded by DpenOoc */ 

SOH.Scope void SOMLINK DBEPartlnitPartFromStoragetDIVEPart *$omSelf, 

Environment *ev, 
ODStorageUnit* storagellnit) 

< 

DIYEPartData *somThis - DIYEPartGetData(sQfliSelf); 

DIVEParttethodDebug( ’DIVEPart" /DlVEPartlnitPartFromStorage 11 ); 


if (somSelf->IsInitmLized(e v)) 
return; 


fa Only initialize once */ 


somSelf‘>InitPersistentDbjectFronStorage(ev, storagellnit); 

/* Create the ordered collection*/ 
/* to hold facets */ 

^Facets ■ new OOxOrderedCollectioo; 

OIVEPart parent SimplePart Init Pa r tF r omSt or age C somSelf, ew, storagednit); 

} 

fa Called to allow the part to */ 
fa do platform-specific drawing */ 
SOH.Scope void SOKLIiiK DIVEPartDrawfDIVEPart isoaiSelf, 

Environment *ev> 

DDFacet* facet, 

ODShape* InvalidShape) 

{ 

DIVEPartData noaThis - DIVEPartGetOata(somSelf); 

DIVEPa rtHet hodDebug{" DIV E Pa rt", "OIVEPartOrav”); 

/* Get DIVE window handle */ 
HUNO hwndDIVE = (HWND}facet->GetPartInfo(ev); 
if (hwndDIVE UinIstfindovShowing(hwndDIVE)) 

{ 

/* Drawing is done by the DIVE */ 
/* thread */ 

WinPostHsg [hwndDIVE, tot VRNENABLED, OL, 01 ); 

} 

} 

/* Updates facets as needed */ 
$QH_Scope void SOHLBIK DIVEPartdpdateFacetsfOIVEPart *somSelf f 

Environment *ev, 

DDFacet* facet) 

I 

DIVEPartData *somThis - DlVEPartGetData(somSelf); 

DIVEPa rtMethodOebugf" DIVE Part”, ’'DlVEPartUpdateFacets"); 

HilND hwndDIVE = facet->GetPartInfo(ev); 

DDiDrderedCollectionlterator facets(^Facets); 

DDFacet* f * (GOFacet*) facets,FirstQ; 
while (facets.IsNotComplete() = kQDfalse) 

{ 

if (f != facet) 

{ 

HWND hund * (HWND)f->CetPartInfo(ev); 
if (fhwnd If iWinlsWindouShowing(hwnd)) 

f->Invalidate[ev, kflOKULL); 

> 

} 

f = (DDFacet*) facets.NentO; 

} 

} 

/* Invoked when the user actives*/ 
/* the part */ 

S0fl_Scope void SOHLINK DIVEPartJlctiv3teFraffle(DIVEPart * somSelf, 

Environment *ev, 

OOFrame* frame) 

{ 

ODSession *fSession; 


Listing Z A completed program, (Continued on page 46 j 


rides. The FacetMded method is called 
by OpenDoc whenever the user em¬ 
beds a part, so I have placed the cre¬ 
ation of the DIVE PM window here 
and the startup of the animation. 
FacetRemoved is invoked when the 
part is deleted, so I must stop the ani¬ 
mation and remove the DIVE window. 

The Geometry Changed method con¬ 
trols part movement and resizing by 
the user. Note that here we must con¬ 
vert the platform-independent coordi¬ 
nates provided by OpenDoc into plat¬ 
form-specific coordinates for use by 
PM. OpenDoc provides the necessary 
transformation matrices to do the dirty 
work for us. 

The dirty work of actually doing 
the DIVE screen updates is processed 
in a second thread, which was 
spawned when the part was embed¬ 
ded. Therefore, the overridden Draw 
method needs to only tell the sec¬ 
ondary thread to refresh the screen. 

That's it! With the exception of 
converting OpenDoc coordinates to 
PM coordinates, not much has been 
added to accomplish the conversion. 
In fact, the sample lost a few pounds of 
code in the process. This is because 
OpenDoc already handles a lot of low- 
level dirty work such as starting a PM 
message processing loop. What re¬ 
mains is the heart of the application, 
the actual DIVE commands controlling 
the screen updates. This is the future 
of application development—focusing 
on your particular area of expertise, 
not on the periphery code, which is te¬ 
dious but required. 

If DIVE were available on other 
platforms, this sample could also func¬ 
tion on those with minimal modifica¬ 
tions. Assuming the DIVE API was 
portable, only the PM APIs and the 
thread creation APIs would need to be 
recoded. That's quite a bang for the 
buck! 

This fully functioning example, 
complete with a three-dimensional jet 
animation, can be downloaded from 
the OS2DF2 CompuServe forum. Look 
for the file DIVE.ZIP in LIB 13. This 
sample will also be available on a fu¬ 
ture Developer Connection CD-ROM. 



CONCLUSION 

A typical method of starting develop¬ 
ment on a program is to use a working 
template as the starting point. Most 
development toolkits provide the 
source code for dozens of working 
programs, which can be used as work¬ 
ing templates to start development. 
This provides the developer with 
working functionality, which can be 
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IS 


DDTypeToken fSelectionFocus; 

DlVEPartData *$omThis » DlVEPartGetOataisoraSelf); 

DIVEPartflethodDebug("DIVEPart", "DIVEPartActivateFrame"); 

OIVEPart_parent_SimplePart,ActivateFraiiie(soiT»S€lf t ev, frame); 

fSession = somSelf->GetStc rageUnit(ev)->GetSession C ev); 
fSelectionFocus * fSessicn-Hokenizefev, kODSelecUcnFocus); 

if CfSession->GetArb'itrator(ev)'>CetFocusOurrer(ev J fSelectionFocus) ! n frame) 

{ 

ODFrameFacetlterator* facets * frame-XIreateFacetlteratorCev); 

ODFacet* facet * facets->First(ev); 
delete facets; 

nm hwndOIVE - (HWNO)facet->GetPartInf^(ev); 

KVND hundFocus = WlnQuery Fo cus(HVKD_DESKTQP); 

if (hundFocus M hvndDIVE) 

{ 

HVliD hyndShell = WinWindowFromIDCfacet->GettfirdoM{eO-> 

GetPlatformMindow(ev), FID_CLIENT); 
WinPostMsg{facet~>Get FacetHWND(ev), U^_SETF0C0SWIN * 

(HP!RAH}hund$hell t 0); 

> 

> 

/* Invoked when the user actives*/ 
/* the part */ 

SGH_Scope void miNK DIVEPartlctivatingyindov(Dl¥EPart *som5elf, 

Environment *ev, 

ODFrame* frame) 

{ 

©Session *fSession; 

DDTypeToken fSelectionFocus; 

DIVEPartData *so«This - OIVEPartGetOata(somSelf); 

DIV EPa rtHeth odDebug(“DIV EPa rt"/DIVEPa rtIcti v a tingWindow H ); 


DIVEPart_parent_SimplePart_ktivating¥indO¥(somSelf, ev, frame); 

f Session = somSelf~>GetStorageUuit(ev}->Get$e$$ion(ev}; 
fSelectionFocus = fSe$sion->Tokeni_ze(ev, kDOSelectionFocus); 

if (fSession->GetArbitrator(ev)->GetFocusOwne r(ev, fSelectionFocus) s = frame) 

QDFrameFacetIterator* facets 3 frame->CreateFacetIterator(ev); 

QDFacet* facet = facets->First(ev); 
delete facets; 

nm hundDIVE * (HyNO)facet->GetPartInfo(ev); 

HWNO hwndFocus = yintjue r y Focus (HW NO .DESKTOP}; 

if (hundDIVE U WM$tfindowShoving( hundDIVE) A* hwndFocus 1 * hundDIVE) 

¥inPostNsg(facet~>GetFa cet HYND(ev), UH.SETFOCUSWIN, 

(fiPARAH)hvndDIVE, 0); 

} 

> 

^ /+ Invoked when the user actives*/ 

I* the part */ 

$ 0 M_Scope void SOHLINK DlYEPartFocusAcquired(DIVEPart *somSelf, 

Environment *ev, 

QBTypeToken focus, 

ODFrame* ownerFrame) 

{ 

GQSession *fSession; 

DDTypeToken fSelectionFocus; 

DIVEPartData *somThis = DI¥EPartGetData(somSelf); 
OI¥EPartlethodGebug("DIVEPart M , M DIVEPartFocus Acquired 11 ); 

DlVEPart_parent_SimplePart_Focusicquired(som$elf, ev, focus, ounerFrame); 

fSession = somSelf->GetSto rageUnit(ev)->GetSession(ev); 
fSelectionFocus 3 f Session-Hokenizefev, kODSelectionFocus); 

if (focus “ fSelectionFocus) 


Listing 2. 4 completed program. (Continued on page 47J 
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> 


{ 

HWND hwndFocus = WinQueryFocus(HWND_DESKTOP); 

ODFrameFacetlterator* facets * ownerFrame->CreateFacetIterator(ev); 
ODFacet* facet * facets->First(ev); 
delete facets; 

HWND hwndDIVE * (HWND)facet->GetPartInfo(ev); 

/* This will pause the animation*/ 
WinPostAsg (hwndDIVE, WA.VRNDISABLED, OL, OL ); 

if (hwndDIVE kk WinlsWindowShowing(hwndDIVE) kb hwndFocus != hwndDIVE) 

{ 

WinPostAsg(facet->GetFacetHWND(ev), UA.SETFOCUSWIN, 

(APARAA)hwndDIVE, 0); 

} 

> 


/♦ Invoked when the user */ 

/♦ deactivates the part ♦/ 

S0A_Scope void SOALINK DIVEPartFocustost(DIVEPart *somSelf, 

Environment *ev, 

ODTypeToken focus, 

^ ODFrame* ownerFrame) 

ODSession *fSession; 

ODTypeToken fSelectionFocus; 

DIVEPartData *somThis = DIVEPartGetData(somSelf); 

DIVEPa rtAethodDebug( H DIVEPart M ,"DIVEPartFocusLost"); 

DIVEPart.parent.SimplePart_Focuslost(somSelf, ev, focus, ownerFrame); 

fSession = somSelf->GetStorageUnit(ev)->GetSession(ev); 
fSelectionFocus * fSession->Tokeni 2 e(ev, kODSelectionFocus); 

if (focus ** fSelectionFocus) 

{ 

ODFrameFacetlterator* facets * ownerFrame->CreateFacetIterator(ev); 

ODFacet* facet = facets->First(ev); 
delete facets; 

HWND hwndDIVE « (HWND)facet->GetPartInfo(ev); 

... ^ , /* Resume the animation */ 

WinPostAsg (hwndDIVE, WAJRNENABLED, OL, 01 ); 

HWND hwndFocus * WinQueryFocus(HWNO.DESKTOP); 
if (hwndFocus « hwndDIVE) 

{ 

HWND hwndShell = WinWindowFromID(facet->GetWindow(ev)-> 

GetPla t f o rmWin dow(e v), FID.CLIENT); 
WinPostAsg(facet->GetFacetHWND(ev), UM SETFOCUSWIN 
(APARAA)hwndShell, 0); 

WinSetFocus(HWND_DESKTOP, hwndShell); 


} 


> 


/* Invoked by SOA when this 

. /♦ class is initialized 

SOH.Scope void SOALINK DIVEPartsomInit(DIVEPart *so«Self) 

DIVEPartData *somThis * DIVEPartGetData(somSelf); 

DIVEPartAethodDebug("DIVEPart","DIVEPartsomlnit"); 

DIVEPa rt_pa rent.SimplePa rt_ somlnit(somSelf); 


♦/ 

♦/ 


/♦ Initialize ordered collection*/ 
/* pointer */ 


.Facets = kODNULL; 

> 

/* Invoked by SOA when this 
fnB _ /* class is un-initialized 

S0A_Scope void SOALINK DIVEPartso«Uninit(DIVEPart *somSelf) 

DIVEPartData *somThis * DIVEPartGetData(somSelf); 

DIVEPartAethodDebug("DIVEPart","DIVEPartsomUninit"); 

DIVEPart.parent.SimplePart.somUninit(somSelf); 


♦/ 

♦/ 
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augmented until it becomes a finished 
application* Usually, however, the 
samples are severely limited in scope 
and tend to provide only a single 
working piece of functionality, such as 
a bit map viewer or a menu bar. To 


make a fully functioning application 
usually requires the splicing together 
of many provided samples. 

Open Doc can change the way ap- 
plications are designed, programmed, 
maintained, and used for the better. 
You can now disassociate OpenDoc 
from compound documents and think 
of it more as a starting point for appli¬ 
cation development. 

OpenDoc has the technology to 
not only become the application that 
OS/2 users have been waiting for, but 
also the application framework, which 
OS/2 developers have been craving. 
Hope I was able to keep you afloat 
from this DIVE into OpenDoc! 


Robert Yeager has been an SOM developer 
since its introduction in OS/2 2.0. He was the 
co-founder of Synaptec, the leading provider of 
SOM development tools. He is currently finish¬ 
ing work on The Object Factory for Warp V. 3.0, 
which features a visual SOM Interface 
Repository browser and IDL importation capa¬ 
bility. Bob has a B.S. from the University of 
Evansville and an M.S. from Central Michigan 
University. 
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Database Development 


A tutorial on database design with an eye to the future. 

By CHARLES MEYER 


Normal Form and Other 
Mantras of Effective 
Database Design 


database, according to the model 1 
have grown up with, in its simplest 
form, is a two-dimensional array 
usually characterized as a table of rows and 
columns commonly represented by a 
spreadsheet* The rows represent so-called 
entities, and the columns are attributes with 
which the entities are endowed, A simple 
example is a mailing database, which con¬ 
tains names and addresses for generating 
labels and possibly includes other informa¬ 
tion about the named individuals that can 
be used for selection purposes. In spread¬ 
sheet form, each row corresponds to one 
label and the columns contain the separate 
bits of required data: names, street ad¬ 
dresses, cities, states, zip codes, and per¬ 
haps phone numbers, business addresses, 
and other facts about the people repre¬ 
sented. For example, a university's alumni 
mailing list might include the year of grad¬ 
uation, degrees, honors, and whether the 


software object orientation, and World 
Wide Web hypertext links, this simple 
model might need to be enhanced in vari¬ 
ous ways. V m inclined to argue, however, 
that its underpinnings remain substantially 
unchanged* One might add to the attributes 
an image depicting the alumnus/a at the 
graduation ceremony, a sound byte from 
the phone call that explains how the check 
for the current dues payment is in the mail, 
or even drop in a pointer to a folder that in¬ 
cludes yet other objects associated with this 
person. Nevertheless, we can still work 
from the spreadsheet model in which these 
additional attributes are handled by new 
columns with pointers linking the entity to 
these various objects. 

This brings us to our first design topic: 
refining table structure. Upon closer exami¬ 
nation of the mailing database, you may no¬ 
tice that each entity has been endowed with 
a certain amount of redundant information 



current dues to the Alumni Association are 
in arrears. 

In the current frenzy for multimedia, 


that might be worth eliminating* A simple 
example is the state of residence and the zip 
code. Perhaps, out of a desire to sustain the 
moral fabric of America, 



First Name 1 
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1234 

0000 
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1234 
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1234 

1234 
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555-16 

555-16 

555-59 

555-36 

555-87 

555-44 

555-38 

555-69 

555-81 

555-22 

5S5-2G 

555-87 

555-17 

555-42 

532-02 

230-37 

432-86 


postal zip codes are not 
permitted to cross state 
lines. Accordingly, if I 
know people's zip 
codes, then I know the 
state in which they live. 
I could, therefore, elim¬ 
inate the state field 
from the records in my 
mailing list by adding 
to the database a sepa¬ 
rate table in which zip 
codes and states are 
matched* To print the 
address, the label pro¬ 
cedure first checks the 


Figure t Part of the original, unrefined alumni mailing fist 


zip code, then goes to 
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the new zip/state table to retrieve the two- 
character state code. It probably takes 
longer, but it's much more elegant and, 
more important, it dramatically enhances 
data management. Okay, so there's not 
much management enhancement here, but 
consider the following similar scenario. 

Suppose, for the sake of this illustra- 
tion, the U.S. Postal Service and Ma Bell de¬ 
cide to give zip codes and area codes coin¬ 
ciding boundaries. In your mailing 
database, you eliminate the redundancy by 
creating a table that links area and zip 
codes, if you know the zip code, you have 
the area code because no zip code region 
crosses area code boundaries. Now, as it 
happens, the phone company is running out 
of numbers in the present area code blocks, 
and they plan to realign them. Suddenly, 
5,000 records in your mailing database must 
have the area code field changed to reflect 
the new assignments. So, which method 
will be the fastest and most accurate: chang¬ 
ing 5,000 records individually and worrying 
about whether you forgot or made any mis¬ 
takes, or going to the area/zip code table 
and changing just the zip code records that 
have received new area code assignments? 
Therein lies the gain, which is to be had by 
building so-called relational or hierarchical 
databases with linked tables joining shared 
information. 

NORMAL FORM 

The type of construct we have just reviewed 
is formalized in a set of standards called 
Norma! Form. Normalizing a database en¬ 
sures that the attributes associated with any 
particular table belong only to the entities 
singled out in the 
records of that table. In 
less jargon-laden terms, 
normalizing a database 
makes sure that each 
column in the table's 
spreadsheet says some¬ 
thing unique and spe¬ 
cific about the occupant 
of each row. In addi¬ 
tion, Normal Form sets 
standards for the rela¬ 
tionships that may be 
defined between one 
table and another. 

These standards go 
well beyond the simple 
removal of redundancy 


within records. The rules for their imple¬ 
mentation are sometimes written in a lan¬ 
guage near and dear to the theoretical 
mathematician, so in the interest of clarity, I 
will endeavor to paraphrase and offer some 
illustrations. 

The mailing database currently has two 
tables: the alumni table, which uses some¬ 
thing unique to the individual like a Social 
Security number as a key to identify each 
record, and the zip/area code table, with 
zip code as its key. The two tables are 
joined on the zip code field, which they 
share. For the sake of the following exam¬ 
ples, assume that the alumni table also has 
fields for degree earned and in what year, 
the major area of study, and up to three 
past and present employers along with hire 
dates and job titles. 

The head of the Alumni Association 
has decided that the mailing list should be 
expanded into a more comprehensive data¬ 
base. You review the records, and your at¬ 
tention is drawn to the repeating groups of 
employers, hire dates, and job classifica¬ 
tions. This violates the stated goal of mak¬ 
ing each assigned attribute unique. We cur¬ 
rently have three different sets of attributes 
providing inherently similar Information 
about each entry in the mailing list. It 
makes more sense to separate these into a 
table of their own, with a separate record 
for each employer. The key will be a combi¬ 
nation of two fields, the alums' Social 
Security number, identifying the corre¬ 
sponding record in the alumni table, and 
the name of the employer. The additional 
attributes are the hire date, the job title, the 
degree earned at the school, and the major 
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Figure J. The three linked record types in the billing system , 



subject area of study. The latter fields 
have been included to indicate the 
suitability of the educational experi¬ 
ence to the job currently held (or not, 
as the case may be), such as the CEO 
has an MBA. 

A second set of potentially re¬ 
peating groups is the degree received 
and the year of graduation. While 
most received only a single degree. 


some may have stayed on or returned 
for one or more advanced degrees. A 
separate table, keyed jointly on 
alumni code and degree with gradua¬ 
tion date as the remaining attribute, 
would take care of this repetition. 

The elimination of these explicit 
or potential repeating groups places 
the alumni table into First Normal 
Form. It has the further advantage of 


more easily adapting to situations 
where there are more than three em¬ 
ployers to track. 

In taking a second look at the 
alumni-employer cross-reference 
table, there appears to be something 
not quite right about having dupli¬ 
cated the degrees and subject majors 
in each of these records. While includ¬ 
ing this information may have some 


You wouldn’t use a light-weight 
development tool to build a 
business-critical system. 

So why would you use a light-weight 
testing tool to test it? 

The Automated Test Facility was built 
to test the kinds of client/server systems 
that go directly to a company's bottom 
line: customer service, claims adjustment, 
loan processing, inventory management. 
Systems where reliability and quality 
are essential. 

ATFs unique ability to do multi-user 
workflow testing has made ATF the 
testing tool of choice for corporations 
building business-critical systems 
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Want to hear more? Calf 61 7-576-2257 
(or fax 61 7-864-7747), 
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FORM RELATIONSHIP 

BETWEEN ^ 

Form 1: 

If Form 1 is Subform, how should Key 
field be upd ated when, Main form Key 
is modified: I IV 11 

& Form 2: 

If Form 2 is Subform, how should Key 
field be upd ated when Main form Key 
is modifled 


Restrict (Don't Update) 


RSFO ON THE FOLLOWING FIELDS BEI MG EQUAL: [Define at least one set I 


Field 
And Field 
Rnd Field 


Product Code 

: i 

roduct Code 


= 



OPTIONAL RELATIONSHIP NAMES: 

[Form names are used as a default.) 


for For 


Form 2: H.!.|UI|.B:UMffWgTl 


Figure 4 * Data Ease maintains referential integrity when defining the relationship between product 
and invoice. 


merit for the university's image, it is 
logically unsound from a design per¬ 
spective* The hire date and job title 
are attributes of both the individual 
and the indicated company taken to¬ 
gether, and hence inform about the 
entire record key, which combines 
both the individual and employer 
fields* The degree and area major say 
something only about the individual, 
not about the company. Remembering 
that a goal of Normal Form is to 
achieve attributes both unique and 


specific, these two attributes should 
properly (or normally) remain back in 
the alumni table, where they are spe¬ 
cific to the individual members, in¬ 
stead of being inserted into the 
alumni-employer cross reference* 

Returning the degree and major 
to the alumni table places the cross- 
reference table in Second Normal 
Form. All attributes are associated 
with the entire compound key, not 
merely with some parts of that key. 

The alumni table is in First 


Normal Form because we eliminated 
repeating groups and in Second 
Normal Form by default (because it 
has no compound key). The elimina¬ 
tion of the zip/area code redundancy 
has also placed it in Third Normal 
Form. Given the hypothetical scenario 
sketched out earlier, the area code has 
effectively become an attribute of the 
zip code and is no longer specific to 
the alumni list member. The goal of 
Third Normal Form is to remove 
overlapping and, hence, redundant 
attributes within a table, consigning 
them to tables of their own where the 
data can be more easily managed. In 
essence, without the introduction of 
the area code/zip code table, we have 
two attributes doing the work in a 
table where one will suffice. 

There are also Fourth and Fifth 
Normal Form standards that relate to 
the isolation of independent or seman¬ 
tically related multiple relationships* 



REFERENTIAL INTEGRITY 

Normal Form is designed to protect 
information by splitting it up in vari¬ 
ous ways. For example, in the alumni 
database, it might be advisable to 
break out employers into their own 
table instead of confining them to the 
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H alumni-employer cross reference. If 
the last alum who worked for a given 
company dies and is removed from 
the records, all record of that com¬ 
pany goes too. But, splitting up infor¬ 
mation is not without its adverse con¬ 
sequences, which brings us to our 
second topic—referential integrity. As 
soon as you decide to distribute infor¬ 
mation among multiple tables, you 
have to deal with what happens to the 
data in one table when you make 
changes in another. 

To change illustrations, a billing 
system contains a table of customer 
information, including discount rates 
based on volume, a product table, and 
an invoice table containing records of 
current and past transactions. The 
price paid on the invoice is calculated 
from the list prices, taken from the 
product table, and the discount rate 
from the customer table. 

What happens in the invoice table 
when there is a change in the product 
table's list price or in a customer's dis¬ 
count rate? Common sense dictates 
that the change should only be applic¬ 
able to invoice records created after 
the date of the revision. This can be 
handled by incorporating the revision 
date in the "parent" customer or prod¬ 
uct record and using a compound key, 
which contains the new rate or price, 
plus an effective date to define the af¬ 
fected invoice records. Easy enough. 
On the other hand, if business is good 
and it becomes necessary to expand 
the number of characters in the cus¬ 
tomer account key, such a change 
should be cascaded through all the as¬ 
sociated invoices and any other tables 
containing customer-related informa¬ 
tion. Last, let's suppose a customer 
leaves the fold and the corresponding 
customer record is deleted. Should the 
corresponding invoice records be 
deleted at the same time, archived, or 
left in their original locations in the in¬ 
voice table? The challenge for the de¬ 
veloper lies in identifying all of these 
potential scenarios during discussions 
with the client user and then including 
the required fields and associated rou¬ 
tines to cover them. However, equally 
important is that the database develop¬ 
ment tool chosen for the project is, 
shall we say, robust enough to accom¬ 
modate these demands. 

DATABASE 

There aren't a great many develop¬ 
ment tools written specifically for 
OS/2 or tools that have been ported 
over successfully from either the DOS 
or Windows arena, but one interest- 
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ing exception is DataEase, a product 
from DataEase International Inc. 
DataEase has had OS/2 versions dat¬ 
ing back to the days of the I.x ver¬ 
sions and, only recently (with release 
5.0), has marketed a complete 
Windows offering. DataEase supports 
multi-user applications through net¬ 
work file- and record-locking fea¬ 
tures. Through a separate product, 
SQL Connect, DataEase applications 
can be defined in a client or server en¬ 
vironment, using the same client side 
features that are available for desktop 
and LAN-based projects. Over the 
years, DataEase has remained a solid 
development tool, which has not only 
won a following in the user market 
but has also formed the basis of sev¬ 
eral commercial applications. 

1 cite DataEase here because, in 
addition to offering a native OS/2 
version, it is a tool in which I have 
done the majority of mv database de¬ 
velopment projects. It was not a prod¬ 
uct of choice, but one already in place 
when I joined the law firm where I 
work. Nevertheless, having done 
maintenance work in other systems, 
DataEase is the product 1 always re¬ 
turn to for new applications. As its 
name is intended to suggest, it is ex¬ 
tremely easy to build quick and clean 
prototype systems. Where I work, liti¬ 
gators are busy with the process of 
discovery, and rarely discover the 
need for data-processing support 
until the eleventh hour. This some¬ 
times means that I hear about the 
needed application on a Friday, and it 
must be finished and into production 
on the following Monday, 

DataEase incorporates a number 
of built-in features that assist in 
achieving the standards of normal 
form and referential integrity. It thus 
serves as an illustration of how these 
requirements can be enforced in ap- 
plications that are written using third- 
party development software* 

UNKING TABLES 

With respect to referential integrity, 
DataEase links tables with a simple 
method that uses up to three related 
fields. When defining a relationship 
between two tables, the designer has 
the option of specifying how changes 
in the key fields defining the linkage 
should be handled. 

The choices are Cascade, Null, 
and Restrict. Cascade means that 
child records will be changed to re¬ 
flect changes in the parent and are 
deleted when the parent record is 
deleted. In other words, modify or 
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lose the customer and the invoices are 
modified or deleted as well. 

Null means that the correspond¬ 
ing key value in the child records will 
be set to BLANK when the value in the 
parent is changed. The child records 
are still deleted along with the parent. 
The advantage of Null is to purposely 
orphan the child records so that a fol¬ 
low-up can isolate them and process 
them appropriately. 

Restrict means that changes in 
the parent, including deletion, leave 
the child records unaffected* In SQL 
Connect, two additional integrity 
rules are included to enforce the 
Cascade and Null options on the 
server engine. 

COMPOUND INDEXING 

In earlier versions, DataEase wasn't as 
congenial to the rules of Normal Form 
as it has become in the current re¬ 
lease. This may seem like an odd com¬ 
ment, since Normal Form appears to 
be inherently a design issue without 
regard to the chosen development 
tool. True enough* But realizing the 
chosen design, without making com¬ 
promises or sacrificing performance, 
depends on the underlying software. 
By way of example, enforcing the first 
and second rules of Normal Form can 
be enhanced by the ability to create 
and maintain compound indexes over 
multiple fields in a record table. 

In earlier versions of DataEase, 
indexing was restricted to individual 
fields. To build a compound index re¬ 
quired the creation of an indexed 
"dummy" field made up by joining 
the content of the fields logically con¬ 
nected as the record key. The "join- 
text" function that accomplished this, 
as its name suggests, converted field 
values of distinct types into a com¬ 
mon text format. This loss of the origi¬ 
nal field characteristics frequently 
proved impractical for purposes of 
linking records into their required 
relationships* 

The current 5.0 release now sup¬ 
ports the creation of true compound 
indexing, incorporating fields with 
distinct type characteristics. There 
are, however, two limitations. If you 
are building tables that will be ac¬ 
cessed from the DataEase for 
Windows software, as well as from 
OS/2 or DOS, tables with compound 
indexes will be viewed as read-only 
from that perspective. Users will be 
able to view but cannot create or 
modify the associated records. 
Additionally, compound indexes can¬ 
not be defined on SQL or other for- 


eign database tables. At least it's a 
step in the right direction. 

In choosing a development tool 
for application building in the OS/2 
operating environment, your decision 
ought to be based at least in part on 
how well and how easily the product 
enforces the design standards you 
should be following. If you are think¬ 
ing about checking out DataEase, one 
downside for OS/2 developers is that 
DataEase for OS/2 is still text-based 
like its DOS cousin. On the other 
hand, with a few exceptions like the 
one noted above, the file formats for 
the 5.0 DOS, Windows, and OS/2 re¬ 
leases are fully equivalent. This can 
offer an advantage in a setting where 
the users may have a variety of front- 
end operating environments on their 
desktops. 

Charles R. Meyer, who holds a PkD. in logic 
and philosophy of science, is senior PC applica¬ 
tions specialist with the law firm of Bryan Cave 
LLP. Charles has been part of the firm's MIS 
department, based in St. Louis, MO, for eight 
years , and is responsible for programming and 
database development in support of both 
administrative and case management projects. 
Prior to that he worked as a programmer and 
independent consultant and has also taught 
database design and programming. 
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Database Development 


Writing an OS/2 database application, using a genealogy database as an example. 

By JAKE JACOB 



A Multi-Platform 
Database Library 


bout 10 years ago 1 was looking 
through some family scrapbooks 
and photo albums when Mom said, 
"Why, you could put this all on your com¬ 
puter, couldn't you?" And without thinking 
(obviously!) I replied, "Sure, that's what 
they're for." Envisioning perhaps as many as 
200 names, 1 started writing a simple pro¬ 
gram to record and organize the information 
and print the results. 

By now my records include nearly 3,000 
names, 5 MBytes of text data, and 150 
Mbytes of photographs* It's time to start 
thinking database program! So when Simple 
Software Solutions offered me an opportu¬ 
nity to beta test its new database library, I 
asked some questions and was persuaded to 
try it. Although 1 don't expect to use all of its 
capacity, I wanted to be able to write my 
own data entry and reporting functions. 

My genealogy database uses multiple 
tables to define pa rent-chi Id and marriage 
relationships and link them to text and pho¬ 
tographic data. When 1 finish all the "bells 
and whistles," users will be able to view and 
print information about an individual or a 
family. It's fun to step back from parent to 
grandparent and see their pictures and read 
about their activities* 

AN EVENT-DRIVEN DA TABASE LIBRARY; E_ DB 

This article describes e_Dh, a database li¬ 
brary product that will soon be available for 
most popular development platforms, in¬ 
cluding OS/2 Warp. The "e" in c_Db stands 
for events, since the database engine posts 
events back to the application to inform it of 
changes, additions, and deletions* 

The product is a comprehensive set of 
functions, which allows a developer to create 
and maintain databases from applications 
written in C, C++, VisualBasie, and other 
languages that can access functions in a DLL, 


Besides the basic INSERT, DELETE, UP¬ 
DATE, and SELECT operations, e_Db pro¬ 
vides many other useful functions. 

The appealing aspects of e_Db are: 

* It completely hides the details of opening, 
closing, and sequencing table and index 
files. 

* Its search engine examines the search ex¬ 
pression to determine what indices (if 
any} to use and how to conduct the search 
most efficiently. 

* It posts events to inform the calling appli¬ 
cation of database changes, table addi¬ 
tions, and indices dropped. These events 
are also used to allow customization of the 
database engine's behavior. For example, 
once the maximum number of locking re¬ 
tries has been reached, e_Db posts an 
event asking for direction: continue try¬ 
ing? stop? 

* e_Db is available for OS/2 Warp, 
Windows 3*1, Windows NT, VisualBasie, 
and DOS* Versions for OS/2 for the 
PowerPC and Windows 95 will be avail¬ 
able when these systems ship* 

* The architecture defines a relationship be¬ 
tween the database engine and its database 
drivers. A database driver DLL relieves the 
engine from having to know the details of 
file format. Version 1.0 of e_Db is shipped 
with a DBASE III database driver but other 
drivers can be developed* The functional¬ 
ity of the APIs remains the same regard¬ 
less of the database driver being used* 

* Data files created and maintained on one 
platform can be accessed by implementa¬ 
tions on other platforms* 

If you develop software in C or C++ 
under OS/2, Windows, NT, or DOS, and 
want to avoid complex database systems, this 
product is worth considering. e_Db's API set 
provides a consistent interface across all sup¬ 
ported platforms* It offers a level of refine- 
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merit not found in most other database 
libraries. You never "see" a table or 
index file, just as you never "see" a file 
in more complex database systems. 
You don't need to write code to scan 
tables or serialize access to tables. 

On the other hand, e_Db lacks the 
user/password validation, referential 
integrity checks, and dedicated backup 
and recovery features found in larger, 
more complex, database systems. 


FEATURES SUMMARY 

With e_Db one can do the following: 

• Create a multiple database dynami¬ 
cally 

• Create and drop tables dynamically 

• Manipulate tables in various file 
formats 

• Handle multiple databases concur¬ 
rently 

• Create and drop table indices dy¬ 
namically 

• Submit SELECT statements against 
any table 

• Submit multicolumn UPDATE re¬ 
quests 

• Submit INSERT and DELETE re¬ 
quests 

• Supply full multithreaded support 
under OS/2 and Windows NT 

• Use wildcard characters ? and * to 
search the tables 

• Set case sensitivity at the database 
level 

• Compose complex, parenthesized 
expressions for SELECT, UPDATE, 
and DELETE statements 

• Use C language structures to manip¬ 
ulate table rows 

• Import and export data to/from a 
table with a single function call 

• Catalog and uncatalog tables dy¬ 
namically 

• Notify when new tables or indices 
are created by other users 

• Notify when maximum number of 
rows is reached during SELECT op¬ 
erations 

• Notify application when tables are 
removed 

• Open a database for exclusive, 
shared, or view only access 

• Treat select results as an array of 
rows 

• Supply a callback mechanism for 
SELECT statements 

• Supply a callback mechanism for 
UPDATE statements that allows 
you to perform special updates. 

DATA TYPES 

Data types that are not directly 

supported by the chosen file format are 

emulated by its database driver. For ex¬ 
ample, in Table 1, CT.WORO (unsigned 


Symbol 

Description 

CTJSTRING 

Fixed-length character 

CTJUHERIC 

Formatted numeric value 

CT.BOOLEAN 

Boolean variable (T' or 'F') 

CTJJATE 

Date column (YYYYMMDD) 

CTJSTRING 

Variable length character 


(DBASE memo field) 

CT.BYTE 

Unsigned binary byte 

CT.WORD 

Unsigned short (two bytes) 

CT.DWORD 

Unsigned long (four bytes) 

CT.FLOAT 

Floating point number (double) 

CT.SHORT 

Signed short (two bytes) 

CT.LONG 

Signed long (four bytes) 

CT.nHESTAHP 

Unsigned short (two bytes) 

CT.COUNTER 

Unsigned long (four bytes) 


(increments automatically) 


Table 1 . e_Db supported data types. 


Column type 

Description 

fstring(n) 

Fixed string of n characters 

numeric(w:d) 

Numeric value of 'w' bytes with'd' decimal places 

boolean 

1-byte wide. Y or N. 

date 

8-byte wide date. YYYYMMDD 

vstring 

4-byte wide reference to a variable length string 

byte 

1-byte wide unsigned value 

word 

2-byte wide unsigned short value 

dword 

4-byte wide unsigned long value 

float 

8-byte wide double value 

short 

2-byte wide signed short value 

long 

4-byte wide signed long value 

counter 

4-byte wide unsigned long value 

timestamp 

2-byte wide unsigned short value 


Table 2. e_Db column types. 


short) is not directly supported in the 
DBASE III file format but the database 
driver emulates it using DBASE Ill's 
'numeric' type. Regardless of the data¬ 
base driver you're using, your applica¬ 
tion always handles a CT.WORD as a two- 
byte unsigned short variable. 

USING A DATABASE 

Let's look at a few of e_Db's APIs with 
some "snippets" of pseudo code to get 
a better idea of how they are used. 

Before you call any other func¬ 
tions, you must create a database en¬ 
gine instance with a call to 
DbmCreateEnginelnstance. This function re¬ 
turns a handle, which is used to create 
and/or open the database(s). 

After the database is created, you 
can dynamically create and drop the 
tables and indices you need. The data¬ 
base instance handle is also used to 
"shutdown" the engine with 
DbmShutdownEnginelnstance. The sequence 
involved in creating and manipulating 
a database is: 


DbmCreateEnginelnstance() 

DbmCreateDatabaseO // if it doesn't exist 

DbmOpenDatabaseO 

DbmCreateTableO 

DbmCreatelndexO 

DbmlnsertO 

DbmSelectO 

DbmUpdateO 

DbmQoseDatabaseO 
DbmShutdownEngineInstance() 

When you create a database the 
engine produces a database dictionary 
file named after the database name 
you specify. This file has the extension 
.dbd. 

For example, 
int rc; 

HDBINST hdbinst; 

rc = DbmCreateEnginelnstance(fthdbinst); 
if (rc == DBSUCCESS) 

{ 

rc * DbmCreateDatabase( 
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Listing h An example of search criteria. I Continued on page 60J 


hdbinst, 

// Database instance handle 
■C:\\GEIEILOG\ 

// Produces C:\GENEALOG.DBD file 
"Hy relations database 11 * 

// Database description (pun 
intended) 

"dbasel”, 

// Database driver (DBASE EU) 
r, db3dHo N t 

// The driver's dll name (OS/2) 
CRDBJVERWmE); 

// Overwrite if exists 

> 

OPENING A DATABASE 

You must open the database in one of 
its three modes before you can use it. 
In exclusive mode, you have full ac¬ 
cess to the database and can create and 
drop tables and indices* In shared 
mode, you cannot drop database ob¬ 
jects, and in view mode, you are only 
allowed to search the tables, and no 
changes are permitted. 

CREATING A TABLE 

A table is defined by a column specifi¬ 
cation containing one or more column 
descriptors of the form "Name 
type(width)/ See Table 2 for column 
types. 

Ln this example, 

HTABLE hTable; 
int rc; 

rc = DbmCreateTable( 
hdb, 

"Genealogy Main Table", 

"Person.Id counter," 

"LastName fstring(30), 11 
"FirstName fstring{30)," 

"Date_of Jirth date/ 

"Pla c e_of .Birth f st ring(SO),* 

"Date_of_Death date/ 

"Place_of.Death fstring(50)/ 
"UpdateDate date/ 


"Comments vstring", 
fthTable); 

would create a table for use in a ge¬ 
nealogy program application. 

CHEATING AN INDEX 

Create an index with the DbrnCreatelndex 
function. If an index already exists for 
the specified column, it will be rebuilt. 

The database engine automati¬ 
cally updates the index as you add, 
delete, and modify table rows. It also 
decides which indices to use during 
the execution of a SELECT, UPDATE, 
or DELETE operation. 


ai 
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TRUE); // trim trailing blanks 

//Oft, extract each colutnn individually with Dbro&etSelectColumn 

rc = Db«iGetSelectColLiflKi( 

bselect, // handle to select results 

i, If the row offset (0-based) 

0, // Table handle (not used here) 

"Date^of.Birth 11 , If Coluw to extract data froi 
szQateofBirth, II Store the extracted data here 
TRUE); // Trim blanks from result 

> 

Finally, tree the memory associated with the select results handle 
DbmFreeSelect(hselect); 

Search expressions are reusable from one operation to another, however, 
they can only he used by one thread at a time* 

Listing 1. An example of search criteria. (Continued from page 59.) 


ADDING ROWS TO THE TABLE 

A "data space" is associated with a 
particular table and is an internal rep¬ 
resentation of the data buffer that 
holds the data for one row. Once you 
have a valid "data space handle/' you 
can set the column values or, if you 
have an appropriate C structure you 
can transfer its contents to the data 
space all at once, A data space is cre¬ 
ated by a call to DbmCreatDS, 


The easiest way to insert a row into 
a table is by transferring the contents of 
a structure (or VisualBasic user-defined 
data type) directly to a data space be¬ 
fore calling Dbmlnsert* If you are not 
using structures to manipulate the table 
rows, you must fill the data space by 
using DbmSetColumn for each column, 

SEARCHING A TABLE 

To search a table, call function 


DbmSelect, For example, you may want 
to search the "Genealogy Main Table" 
for all people born between 1800 and 
1850, The search criteria is put together 
in the form of an expression before 
you call DbmSelect. An example is 
shown in Listing 1. 

UPDATING THE TABLE ROWS 

You can choose to update one or more 
columns in each call to DbmUpdate. This 
function uses a search expression like 
the one used by DbniS&lect. 

You can update a column by set¬ 
ting it to a specific value, adding to its 
current value, or subtracting from its 
current value. You can also perform 
search/rep lace on the value of a string 
column; add or subtract days, months, 
and/or years to a date column; or 
change the case of a column to upper 
or lower case. 

If an update procedure is specified, 
the engine invokes it before updating a 
column's value* The update procedure 
can choose to continue, make its own 
changes to the column, or bypass the 
operation completely. This mechanism 
allows the programmer to perform up¬ 
date actions that are not directly sup¬ 
ported by the database engine. 

The special form of UPDATE,, 
ADD and UPDATE_SUB allows me to 
add or subtract days, months, and years 
to or from a column of type CT_DATE. 

Listing 2 is an example of how to 
update my database to reflect John 
Smith's correct date of birth. 

CATALOGUING A TABLE 

If you have a table in the proper file 
format (dbASE III for version 1.0), then 
you can incorporate it into the data¬ 
base by "cataloguing" it with 
DbmCatalogTable, On return from this 
function, you can use the table as if 
you had created and populated it 
yourself* Use function OtunU^catalogTable 
to perform the reverse operation. 

EVENT HANDLING 

The e_Db database engine optionally 
calls back your application when cer¬ 
tain events occur. Your event handler 
receives a message ID that tells it 
which event took place. Event mes¬ 
sages are shown in Listing 3. 

IMPORTING AND EXPORTING TEXT 

You can import text from a file into an 
existing table using ObmlmportTable. The 
file must consist of lines of text sepa¬ 
rated by CR-LF combinations. The first 
line of the file must be a table defini¬ 
tion string similar to the one passed to 
DbmCreateTable. For example, 


HTIBLE hTable 
irtt rc; 
long count; 

HUB hub; 

rc = Ob*£reateEiEpressifln£hTable, fthexp); 
if (rc = DBSUCCESS) 

{ 

DbmAddEx pressionTerm( hexp, "LastName 11 , QP.EQ, "Smith"); 
Dbm*ddLogicalJQperator(hexp, LOGOPJNO); 

DtbmAddE*pressionlerra<heifp* "FirstName"* OPJQ, W); 

rc E DbmCreateUpdateBlk( 

hTable, // Table handle 

fchub); If Update block handle returned here 

if (rc » DflSUCCESS) 

< 

//Set John Smith's date of birth to 10-12-53 
DbmAddUpdateAction(hub, "Datejjf.BArth", QP_SET, "19531012"); 
rc * DbdJuickUjxtete( 

heap, // Handle to search expression 
hub, // Update block handle 

ftcount); // Count of updated rows returned here 
// Only one roe in this case. 

DbmF reellpdate&lk (hub); 

> 

DbmFreeEipression(hexp); 

) 


Listing Z How to update database reflecting correct date of birth. 
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Here is a list of e_Db 
functions by category: 

Instance handling functions: 

ObinC rea t eEngin el n stance 
DbiiiS hut do ifiEnginelnst a nee 

Database handling functions: 

DbntQueryDbDrvCLass 

DbmOpenDatabase 

DbeQoseDatabase 

ObmCreateDatabase 

ObmDropDatabase 

DbmQueryDblnfo 

DbmQueryDbTables 

DbfflQuerjfDblhdices 

ObmPremoteAccess 

DbmSetCa seSensiti vitjf 

ObmSetftetr yPa raraete rs 

Table handling functions: 

Obra&etTableHandEle 

DbdiCatalogTable 

DbfnCreateTable 

ObmDropTable 

DbmE<portTable 

DbmlmportTable 

DbmQueryTablelnfo 

DbmQ ue r yTableCol joins 

DbcnQ ue r ylablelndices 

DbmUncatalogTable 

DbrnWidestTableColumn 


DbmPackTable 
DbmGetTableR o wCount 

Search criteria expression 
handling functions: 

ObmC reateE t press!on 
Obm A ddE xpressio nT e rut 
DbrnAddStringTerm 
Dbtn A ddE ip reSSiOfiPa ren 
DbmA ddL ogicalDpe rator 
DbnFreeExpcession 

Join handling functions: 

DbfliCreateJoin 

DbmAddJoinTenn 

DbmFreeJoin 

UPDATE handling functions: 

DbmCreateUpdateBlk 
DbmAddUpdateAction 
Dbtn A ddbpdateString 
DbmUpdate 
DbmQuickUpdate 
ObmFreeUpdateBlk 
KmJQIoc 
Dbtnfree 

INSERT handling functions: 

ObmCreateDS 

ObmQearDS 

DbmCetC olumn Uidth 

DbmSetCclumn 

ObrnSetEi! tColumn 

ObmSetStruct 


DbmQuicklnsert 

Obmlnsert 

ObmCetColumn 

DbmFreeDS 

Index handling functions: 

ObmCreatelmlex 

ObmOropIndeK 

SELECT handling functions 

DbmSelect 

DbmQuickSelect 

DbmFreeSelect 

DbmFreeSelectRov 

DbmQu ery SelectCount 

ObmCetSelflctStruct 

DbrnCetSelect Column 

DELETE handling functions: 

DbmDelete 

DbmQuickDelete 

Event handling functions 

DbfnSetEifentProc 

DbmOefaultEventPro 

Special performance-related 
functions: 

DbntockTable 
DbmUnlockTable 

Error handling function 
ObnRetrieveString 



name fstring(lO), address fstring(30) CR-LF 
“John Doe"* "2659 SE 14th Street" CR-LF 

To export the contents of a table to 
a text file use DbmEx portla ble. 

LOCKING & UNLOCKING TABLES 

Locking and unlocking of tables is 
handled by the database engine. 
Whenever needed, calls to Dbmlnsert, 
DbmSelect, DbmDelete, DbmUpdate, lock the 
table(s), perform the given operation, 
and then unlock the table(s). 

UTILITIES 

Utilities are included to allow you to 


quickly create databases, tables, in¬ 
dices, query table contents, update 
columns, and catalog tables. I found 
GENHEAD.EXE a particularly useful 
utility. When given the name of a data- 
base dictionary file (.dbd), it produces 
a header file with all the typedef state¬ 
ments required to manipulate the rows 
in native C or C++. Another utility 
called GENVB.EXE generates a similar 
file for use with VisualBasic. 

CLOSING THOUGHTS 

I found e_Db a good compromise 
between a simple database library 
package and a complex database sys¬ 


tem. It is a database library that does 
most of the work for me while pro¬ 
viding portability, speed, ease of use, 
and robustness. 


Jake Jacob is a retired (really!) IBMer who 
began programming when it was called wiring 
control panels . He s been involved with PCs 
since their inception and has taught program¬ 
ming languages, desktop publishing, graphic 
arts and word processing classes . He is cur¬ 
rently an independent consultant working in 
desktop publishing. He can be contacted at 
(407)395-6069 oral CompuServe 76305,2510 


REFERENCES 

The e_Db product is shipped with 
three manuals: an installation guide, 
programmers" guide, and a pro¬ 
grammers reference. A technical doc¬ 
ument providing additional product 
information is also available. 

All are available from: Simple 
Software Solutions Inc., 2659 SE 14 
St., Pompano Beach, Fla. 33062. 
Voice: 305-782-8385, fax: 305-782- 
0818. CompuServe 72143,2024, in¬ 
ternet cportela@gate.net 


Event symbol 


Description 


DBMJEW_T»BLE 


Another user added a table to the database 


E>BN_NEONDE* 


Another user added An index to a table 


DBH_RETR¥_APPROVE (f the internal number of retries is exceeded, the system 

calls your event handler to decide whether to continue or to terminate the opera¬ 
tion. 


D6H_SELECT_LIMT Whenever a select operation encounters more rows than 

you specified as maximum, this event is sent to your event handler so that it can 
decide how to proceed, DBM_SELECT_ROW. Optionally you can receive a mes¬ 
sage for each row matched in a call to PbmSelect. 

Table 3. Event message table. 
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Spotlight Tools for the PowerPC 


The staff of OS/2 Developer put together this special section to guide you through the various software 
tools specifically for the PowerPC. The products described in this guide are based on surveys sent to 
vendors; they are provided as a service to you and are free to vendors. These listings do not represent an 
endorsement by OS/2 Developer. Although every effort has been made to ensure accuracy, we do not 
assume any responsibility for error or omission in this section. Contact vendor for availability. 



Tools for the PowerPC 
Buyers Guide 


ABRAXAS SOFTWARE INC. Circle No. 130 

FCYACC 5.0 is a complete Language 
Development Environment that generates 
ANSI C and C++ source code from input 
Language Description Grammars for build¬ 
ing assemblers, compilers, interpreters, 
browsers, and so on. This product generates 
C++ and YACC classes for OS/2 2.0 
Presentation Manager. In addition, PC YACC 
builds systems with full error handling, 
recovery, and reporting. Price: $995. 

CodeCheck 5.0 is a programmable tool for 
managing all C and C++ source code on a 
file or project basis. It is input-compatible 
with all variants of K&R, ANSI C, and C++. 
CodeCheck allows corporate coding and 
project specification standards to be auto¬ 
mated for compliance validation and will 
identify code that will not port between plat¬ 
forms. Price: $995. 

Abraxas Software Inc., 5530 SW Kelly, 
Portland, Ore. 97201, (503) 244-5253, fax 
(503) 244-8375. 

ACCESS Circle No, 131 

dSIGN for Windows 2.5 databased publishing 
package allows retailers and distributors to 
create shelf signs, bar code labels, and cus¬ 
tomer mailings with WYSIWYG, linking 
them to databases using FoxPro 2.5 Data 
Manager and downloading to Portable 
dSIGN/2-32 in-store under OS/2. The prod¬ 
uct allows printing using PostScript laser 
printers. Price: $995. 

Access, 3131 Western Ave., Ste. 530, 
Seattle, Wash. 98121-1028, (206) 285-4994, fax 
(206) 285-1807. 

ACCUSOFT CORP. Circle No, 132 

AccuSoft Image Format Library 5.0 supports 
raster formats: TIFF, JPEG, PCX, GIF, DIB, 
WPG, BMP, TGA, PICT, EPS, WMF, DCX, 
PCD, IFF, SUN, PSD, ASCII, and 19 more. 


The product has the ability to import export, 
convert, compress, scan, display, and print. 
Image processing includes: rotate, invert, 
zoom, pan, scroll, color reduction, edge 
detect, laplacian, thumbnails, and so on. It 
works with any OS/2 language that sup¬ 
ports DLLs. Price: $1,295. 

Accusoft Corp., 2 Westborough Business 
Pk., Westborough, Mass. 01581, (508) 898- 
2770, fax (508) 898-9662, 

ARITYCORP, Circle No. 133 

Prolog 32 for OS/2 provides power of the 
Arity/Prolog language in addition to the 
superior performance of the 32-bit environ- 
ment. This product eliminates many 
imposed 16-bit environment limitations for 
language and system performances. Price: 
$995. 

Arity Corp., Damon Mill Sq., Concord, 
Mass. 01742, (508) 371-1243, fax (508) 371- 
1487. 

AUTOTESTER INC . Circle No. 134 

Auto Tester for OS/2 3.0 is an automated testing 
tool designed specifically for OS/2 PM 
applications. AutoTester builds structured, 
object-oriented, well-documented tests as 
you operate an application. The product sup¬ 
ports variables and external test case data, 
conditional branching, and text and bitmap 
data comparisons. In addition, it includes a 
menu-driven interface as well as a powerful 
command language for advanced scripting 
needs. Price: contact vendor 

AutoTester Inc., 8150 North Central 
Expwy., Ste. 1300, Dallas, Tex. 75206, (214) 
368-1196, fax (214) 363-2886. 

BENTL Y SYSTEMS INC. Circle No. 135 

MicroStation 5.5 is a full-featured 2-D/3-D 
professional computer-aided design product. 
In addition to its consistent, intuitive, graph- 
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ical user interface and flexible command 
structure, the 2-D production drafting tools 
are the force behind MicroStation's work- 
group-oriented approach. It is capable of 
running programs written in the 
MicroStation development language. Price: 
$3,950. 

Bently Systems Inc., 690 Pennsylvania 
Dr., Exton, Pa. 19341, (610) 458-5000, fax 
(610) 458-1060. 

CAP AUTOMA TION Circle No. 136 

CAP Accountant is a DOS-based accounting 
system that can be run on a cash or accrual 
basis and will generate real-time financial 
and accounting reports. In addition to doing 
regular general ledger accounting functions, 
it will also keep track of your checkbook bal¬ 
ance and allow easy bank reconciliation. 
Price: $495. 

CAP SellWise 95.2 replaces manual work 
with automatic inventory control, product 
re-ordering, serial number tracking, accounts 
receivable, and customer tracking. Sales sta¬ 
tions continue to operate following any net¬ 
work failure. Information appears instantly 
with the standard reports for any date range 
without posting, closing periods, batch pro¬ 
cessing, or manual calculating. SellWise cap¬ 
tures the information for each sale, inven¬ 
tory, customer, and vendor, and shares it 
with back-office management in real time. 
Price: $1,495 for a single user. 

CAP Automation, 3737 Ramona, Fort 
Worth, Tex. 76116, (800) 826-5009, fax (817) 
560-8249. 

CIRRUS TECHNOLOGY INC. Circle No. 137 

UniteLite 1.5 is designed for small work¬ 
groups to reduce storage and handling 
requirements associated with paper files and 
folders. It is an image and photograph stor¬ 
age and retrieval tool based on the OS/2 
Workplace Shell and OS/2 Warp. UniteLite's 
capabilities include scanning, viewing, find¬ 
ing, and printing forms, reports, and other 
key documents. Price: $295. 

Unite CD-Maker 1.3 uses IBM's SOM and 
Workplace Shell technology for creating cus¬ 
tom CDs. This product takes advantage of 
OS/2's multithreaded performance to 
increase the speed and reliability of CD- 
ROM creation. Two CD recording methods 
are supported: "bum-on-the-fly" or build a 
virtual CD image file. Both methods produce 
CD-ROMs that conform to the ISO 9660 for¬ 
mat and can be read from any OS/2 system. 


Price: $249. 

Cirrus Technology Inc., 5301 Buckeyes- 
town Pike, Frederick, Md. 21701, (301) 698- 
1900, fax (301) 698-1909. 

COMPUWARE CORP. Circle No. 138 

Uniface is a robust development environ¬ 
ment, which is open and portable. 
Applications built with Uniface have simul¬ 
taneous read/write access to numerous data¬ 
base and file management systems, includ¬ 
ing DB2, Oracle, Sybase, Informix, INGRES, 
and others. A single application runs under 
multiple GUIs and character modes without 
any additional programming. Regardless of 
interface. Uniface applications exploit each 
environment. This product also works with 
several CASE tools, including those from 
Knowledgeware and Intersolv. Uniface has 
been used to build enterprise client/server 
software applications in a wide range of 
industries including financial services, phar¬ 
maceuticals, telecommunications, govern¬ 
ment, and manufacturing. Price: contact ven¬ 
dor. 

Compuware Corp., 31440 Northwestern 
Hwy., Farmington Hills, Mich. 48334-2564, 
(800) 356-3608, fax (810) 737-7119. 

CONTRACCT SYSTEMS CORP. Circle No. 139 

ContrAcct 3.1, a fully integrated contractor 
accounting /job cost management system, is 
designed for contractors. ContrAcct includes 
accounts payable, accounts receivable, cash 
management, equipment, general ledger, 
inventory, job cost, payroll, purchase order, 
and report writer. It is a single entry system 
of source documents with all internal post¬ 
ings performed automatically. In addition, 
this product supports multiple companies 
and multiple users, and offers custom pro¬ 
gramming, individual professional training, 
telephone and modem support, and annual 
updates. Price: contact vendor. 

ContrAcct Systems Corp., 208 N. 
Washington St., Naperville, 111. 60540, (800) 
562-2678, fax (708) 355-8675. 

COP!A INTERNA TIONAL Circle No. 140 

Accsys for Paradox 6.0 enables programmers 
to create and/or update Paradox files. It is 
an interface between C or VisualBasic and 
Paradox (through 5.0), providing the pro¬ 
grammer control over Paradox table files, 
primary, and secondary index files. Accsys 
provides a portable multiplatfom database 
system with a high-level and low-level API 
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for faster application development. 
Price: $495. 

AccSys for xBase 6.0 enables pro¬ 
grammers to create and/or update 
files of dBASE III, IV, Clipper, and 
FoxPro. It combines the power of 
dBASE with the efficiency of C or 
Visual Basic to create more efficient 
applications. AccSys for xBASE pro¬ 
vides a portable muitiplatform data¬ 
base system with a high' and low-level 
API for faster application develop¬ 
ment. Price: $495. 

Copia International, 1342 Avalon 
Ct„ Wheaton, Ill. 60187, (800) 689-8878, 
(708) 665-9841. 

CYGNET PUBLISHING 
TECHNOLOGIES INC. Circle No i. W 

Scribe Document Production Software 7 
(1750) is cost-effective publishing soft¬ 
ware designed for the production of 
large and complex documents. 
Producing high-quality output, it inte¬ 
grates text, graphics, tables, and exter¬ 
nal data from database management 
systems. Price: $895. 

Cygnet Publishing Technology 
Inc,, 355 5th Ave., Ste. 1515, Pittsburgh, 
Pa. 15222, (412) 471-2070, fax (412) 391- 
7215. 

DSTBELVEDERE Circle No, 142 

The Global Portfolio System (GPS) 3.0 is a 

UNrX-based multicurrency portfolio 
accounting and performance measure¬ 
ment solution for institutional invest¬ 
ment advisors. GPS supports all trans¬ 
actions and provides complete 
accounting for all securities and cur¬ 
rencies. With its rules-based design, 
GPS offers the extensibility to meet the 
demands of new markets as they 
emerge GPS is a client/server solution 
that has a platform, relational data¬ 
base, and is graphical user interface 
independent Price: contact vendor. 

DST Belvedere, 470 Atlantic Ave., 
Boston Mass. 02210, (617) 482-8800, fax 
(617) 482-8878. 

FAIRCOM C0RP. Circle No 143 

d-tree Development Tool 3,4A offers 
beginning programmers a bridge to 
the control, flexibility, and portability 
of C development. Experienced pro¬ 
grammers increase results while main¬ 
taining low-level flexibility. Features 
include, productive front-end for c- 
tree, complete portable screen handler, 
menu/HELP management, data dic¬ 
tionary, file-/field-level editing/vali¬ 
dation, resource swapping, and run 
time control of program resources. 
Price: $$495-$745. 

FairCom Server 6.04.24 is a high-per¬ 


formance, multithreaded, transaction 
processing server. Features include, 
industrial quality transaction process¬ 
ing, full commit and rollback, interme¬ 
diate save points and complete log¬ 
ging, automatic log management, 
restart/disaster recovery, user pass¬ 
words, access security and on-line 
administration, deadlock detection/ 
resolution, and read/write locks at the 
record/individual kev level. Price: 
$295-$3,795. 

FairCom Corp., 4006 W. 
Broadway, Columbia, Mo. 65203-0100, 
(314) 445-6833, fax (314) 445-9698. 

FELSINA SOFTWARE Circle No. 144 
A Talk 1.6 is the Microsoft Office 
Compatible telecommunications pack¬ 
age, which includes, Microsoft Mail, 
cc:Mail, Notes Mail, DDE and Net' 
DDE, VT220, VT100, VT52, Tektronix 
4014, H19, V1DTEX, ANSI, TTY; 
X/Y/ZModem, Kermit, CompuServe 
B+, ASCII; BBS, and chat mode, drag- 
and-drop, history buffer, phone books, 
clipboard, help, over 280 modems, 
script language, editor, and autoscript 
Microsoft Office's compatible features 
include toolbar, tooltips, statusbar, and 
advanced help. A-Talk is a certified 
OS/2 Warp compatible by NSTL. 
Price: $79.95. 

Felsina Software, 4440 Finley 
Ave., Ste. 108, Los Angeles, Calif. 
90027, (213) 669-1497, fax (213) 669- 
1893. 

FIRST B YTE INC Circle No. 145 

ProVoice Toot Kit 2.1 allows program¬ 
mers to add synthesized speech to 
their applications. The program passes 
text strings to a speech driver, while 
translating the text into audible 
speech. All of the necessary tools and 
examples are provided to manipulate 
the ProVoice speech technology. Price: 
$599. 

First Byte Lnc., 19840 Pioneer Ave., 
Torrance, Calif. 90503, (310) 793-0610, 
fax (310) 793-0601. 

FOOTPRINT 

SOFTWARE INC Circle No. 146 

IBM Works 2,0 is currently included as a 
part of the OS/2 Warp BonusPak. It is 
an integrated productivity package 
offering word processing, spread 
sheets, charting, database, report 
writer, and personal in form a bon man¬ 
agement tools. IBM Works provides 
integration across the modules and 
with the Workplace Shell. Price: con¬ 
tact vendor. 

Footprint Software Inc., 53 Yonge 
St., Toronto, Ont. P Canada. M5E1J3, 
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(416) 860-0477, fax (416) 860-1780. 

IBM CANADA Circle No. 147 

Visual Age C++ for OS/2 Warp 3.0 extends 
IBM's programming tools to the 
PowerPC. The tools, including parts- 
based Visual and Data Access 
Builders, IBM Open Class libraries, 
integrated C++ programming tools, 
and robust Direct-To-SOM C/C++ 
compilers produce optimized code and 
are consistent with VisualAge C++ for 
OS/2 and the entire VisualAge C++ 
family. PowerPC code generation sup¬ 
port, in an upcoming version of 
VisualAge C++ for OS/2, will also 
allow development of both Intel and 
PowerPC applications from a single 
development platform. Price: contact 
vendor. 

IBM Canada, 1150 Eglinton Ave., 
North York, Ont., Canada. M3C1V7, 
(416) 448-2647, fax (416) 448-4414. 

IBM Circle No. 148 

The Developer Connection for OS/2 sub¬ 
scription can increase productivity by 
providing the most updated tools, pre¬ 
release software, product demos, and 
information needed on today's 
medium CDs. An annual subscription 
to The Developer Connection News keeps 
tools and information from becoming 
obsolete. Each year, receive four vol¬ 
umes including CDs and The Developer 
Connection News, each packed with the 
tools and information you need for 
your Intel and PowerPC OS/2 devel¬ 
opment efforts. Price: $199. 

The IBM Developers Toolkit for OS/2 
Warp Connect (PowerPC Edition) will be 
available as part of The Developer 
Connection for OS/2. The toolkit is 
positioned to assist developers of the 
Power Series family in specific applica¬ 
tions and allow a recompile of existing 
OS/2 applications running on x86 
processors to run on the IBM Power 
Series family. The toolkit includes, 
tools for building programs such as 
linker, archiver, resource compiler, 
object and executable file analysis 
tools; resource editors and build tools; 
SOM compiler and emitters; headers 
and import libraries; online documen¬ 
tation; code tutorials; and debugging 
aids. Price: $199. 

IBM, 100 N.W. 51st. St., Boca 
Raton, Fla. 33432, (407) 443-5180, fax 
(407) 443-2453. 

fCVERIFY INC Circle No. 14$ 

1C Verify 6.5 is a complete PC-compati¬ 
ble credit authorization software pro¬ 
gram designed to provide credit card 
authorization, check acceptance, and 
ATM/debit card authorizations with 


menu-driven simplicity. 1C Verify can 
operate by itself using a pop-up win¬ 
dows or can be integrated into other 
application programs. Additional fea¬ 
tures include: signature capture, multi¬ 
ple transactions/queuing, extensive 
reporting/statistics, address verifica¬ 
tion, modem sharing, and install¬ 
ment/recurring processing. Price: 
$349-1,999. 

IC Verify Inc., 473 Roland Wy., 
Oakland, Calif. 94621, (510) 553-7500, 
fax (510) 553-7553. 

IMAGESTAT CORP. Circle No . 150 

Image Care 2.3 f a document manage¬ 
ment system, is designed with a flexi¬ 
ble graphical interface. Using drag- 
and-drop techniques, the document 
management capabilities, including 
scanning, printing, faxing, and filing, 
can be accessed. This product fully 
supports the PowerPC under OS/2 as 
well as OS/2 LAN Sever and the IBM 
3995 Optical Library family. Price: con¬ 
tact vendor. 

ImageStat Corp,, 2950 31st St., Ste. 
220, Santa Monica, Calif. 90405, (310) 
392-1100, fax (310) 392-6250. 

INFINITYSYSTEMS 

CONSUL TING Circle No. 151 

Infinity is a PC LAN-based policy and 
claims administration system, which 
fully integrates rating, policy issue, 
policy management, claims adminis¬ 
tration, client management, statistical 
reporting, and accounting utilizing 
IBM's OS/2 operating environment. 
Price: contact vendor. 

Infinity Systems Consulting, 7500 
Old Georgetown Rd„ Ste. 700, Bethes- 
da, Md. 20814, (212) 675-1757, fax (212) 
675-5479. 

KELLER GROUP INC Circle No. 152 
Fax Client /Server API Toolkit 2.1 pro¬ 
vides client/server fax services to 
applications on OS/2. Supported fax 
hardware includes fax modems, 
Mwave, SatisFAXtion, Brooktrout, 
GammaFax, and others. The APT 
works with FaxWorks for OS/2, 
FaxPort for OS/2, and other OS/2 fax 
software products in any standalone, 
LAN, or multiline configuration. Price: 
$995. 

Fax Printer Driver Toolkit 2 , 1 facili¬ 
tates writing applications that crate 
and send fax documents. The printer 
driver can be used from REXX, DOS, 
Windows, 16-bit OS/2, and 32-bit 
OS/2 programs. The printer driver 
works with FaxWorks for OS/2 and 
FaxPort for OS/2 In any standalone, 
LAN, or multiline configuration. Price: 


$295. 

Keller Group Inc., 8600 Jewel Ave. 
N., Stillwater, Minn. 55082-9351, 
(612)429-7273, fax (612) 653-1987 or 
(800) 329-3293. 



KNOWLEDGE 

DYNAMICS CORP Circle No 1 153 

wlnstall Multi-Platform 4.0 is an installa¬ 
tion toolkit including distribution disk 
builder, full error handling capabili¬ 
ties, system file editor, one .EXE for 
both DOS and Windows, full C source 
code, no royalties, and a 30-day guar¬ 
antee. Price: $499.95. 

Install Professional 3.3 is a profes¬ 
sional installation toolkit for MS-DOS 
or OS/2. Install features include distri¬ 
bution disk builder, full errror han¬ 
dling capabilities, system file editor, 
full C source code, no royalties, and a 
30-day guarantee. Price: $399.95. 

Knowledge Dynamics Corp., P.O. 
Box 780068, San Antonio, Tex. 78278, 
(210) 979-9424, fax (210) 979-9004. 

LOGOS SYSTEMS INC . Circle No . 154 

AmbuQuai Ambulatory Quality Assess¬ 
ment and Quality Management System 
6.1.1 focuses on issues that have the 
potential to impact the quality of 
healthcare offered to patients under 
the new health programs proposed by 
the executive and congressional 
branch of the U.S. Government. The 
software measures provider/staff per¬ 
formance; continuity of care; enhances 
the quality of patient care; minimizes 
patient risk; and measures patient 
compliance and organization perfor¬ 
mance. Price: contact vendor. 

Logos Systems Inc., 8303 South¬ 
west Fwy., Ste. 500, Houston, Tex. 
77074, (713) 777-8229, fax (713) 777- 
9512. 


MA CROMEDIA Circle No. 155 

Director 4.0 for OS/2 facilitates the 
combining of text, graphics, animation, 
sound, digital video, and interactivity 
to create multimedia productions. 
Director will produce corporate pre¬ 
sentation; entertainment; and educa¬ 
tional CD-ROM titles, simulations and 
visualization; kiosks; digital publica¬ 
tions; electronic reference materials; 
and software demo disks. Price: $1,195. 

Macromedia, 600 Townsend St, 
San Francisco, Calif. 94103, (415) 252- 
2000, fax (415) 626-0554. 

MICROEDGE INC Circle No. 156 

Visual SlickEdit 1.7 features CUA, Brief, 
Emacs, and VI emulations. This editor 
will facilitate programming with its 
project management, SmartPast, syn- 
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tax color-coding, and built-in dialog 
editor. There is a 30-day money-back 
guarantee. Price: $295. 

MicroEdge Inc., P.Q. Box 18038, 
Raleigh, N.C. 27619-8038, (800) 934- 
EDIT, fax (919) 831-0101. 

NETWORK 

TELEMETRICS INC Circle No. 157 

Proview-SNA 1.4 software monitors 
response time and availability parame¬ 
ters on complex, heterogeneous net¬ 
works. It generates active traffic from 
LAN PC workstations to SNA hosts 
and network file servers. It then mea¬ 
sures the end-to-end delay users are 
actually receiving across the network. 
Network-wide results are forwarded 
to a central management station where 
data is stored in a DB2/2 database. 
Charts and tabular reports of real-time 
and historical data are produced to 
verify service level agreements and 
identify performance trends. Price: 
$25,000. 

Network Telemetries Inc., 30125 
Agoura Hills, Calif. 91301, (818) 597- 
7900, fax (818) 597-7929. 

ON-LINE DA TA Circle No. 158 

OnCmd xBase for OS/2 harnesses the 
power and the speed of OS/2, 
enabling you to develop new or 
migrate existing applications from 
dBASE, FoxPro, or Clipper to native 
32-bit GUI applications environment, 
it comes with screen painter, report 
writer, DLL/DDE support, 350+ func¬ 
tions/commands and is client/server 
ready. Unlimited run time and server 
add-on licensing available. Price: $249. 

On-Line Data, 5 Hill St., 
Kitchener, Out, Canada. N263X4, (519) 
579-3930, fax (519) 579-2130. 

PEERLOGIC INC. Circle No. 159 

Pipes Platform 3.5 message-oriented 
middleware provides communications 
services for distributing applications 
across multiple operating systems, 
hardware platforms, and mixed net¬ 
works, These services include, asyn¬ 
chronous, process-to-process messag¬ 
ing; dynamic name series; session 
management services; and cross-plat¬ 
form and multiprotocol support. Pipes 
Platform's flexible communications 
system facilitates developing, distrib¬ 
uting, and maintaining multitier, dis¬ 
tributed applications. Price: $200. 

PeerLogic Inc., 555 DeHaro St,, 
San Francisco, Calif. 94107-2348, (800) 
PEER-601, fax (415) 626-4710. 

PEGASUS DISK 
TECHNOLOGIES INC 


Pegasus Optical Fite System 2.3 is a trans- 
pa rent file and volume management 
system for optical drives and jukeboxes 
under IBM OS/2 2.x and OS/2 Warp. 
Optical drives and jukeboxes appear as 
standard storage devices. This product 
provides a common file system format 
on optical media that is transportable 
across operating-system platforms. The 
software tracks optical volumes stored 
online, nearline, or offline documents. 
Price: contact vendor, 

Pegasus Disk Technologies Inc., 
1600 S. Main St., Ste. 110, Walnut 
Creek, Calif, 94598, (510) 938-5340, fax 
(510)938-5341. 

PR0C0L INC Circle No. 1B1 

Pro col RDBMP 4GL 6.0 is ideal for all 
phases of application development, as 
the product is designed to be portable, 
coherent, compact, and user-friendly, 
Procol's nonprocedural language 
enable 100% of development require¬ 
ments and offers many advanced fea¬ 
tures. Price: starting at $950. 

Procol Inc,, 5995 Gouin Blvd. W., 
Ste, 300, Montreal, Que, Canada. H4J 
2P8, (514) 336-8551, fax (514) 336-8565. 

QUANT TRADING INC. Circle No. 162 
Sector Trading System 2.0 is a real-time, 
fixed-in come, front-office system used 
in trading treasury, municipal, sover¬ 
eign and corporate debt markets. An 
extremely powerful and customizable 
object-oriented application, Sector pro¬ 
vides real-time security pricing mod¬ 
els, analytics, risk analysis, trade-entry, 
and P&L in an intuitive graphical-user 
environment. Price: contact vendor. 

Quant Trading Inc., 100 Prospect 
St,, Stamford, Conn. 06901, (203) 357- 
1919, fax (203) 6119, 

RAIMA CORP. Circle No. 163 

Raima Database Manager 4.0 is a data¬ 
base engine for C and C++ application 
development providing a low-level C- 
AP1 library with over 200 functions for 
database control. The combined rela¬ 
tional and network database model 
features allow modeling of complex, 
real-world database designs with 
high-performance record access. 
Referential integrity is supported at 
the DDL level. It includes support for 
transaction tracking, logging, and 
automatic recovery. In addition, it 
supports all leading OS and comput¬ 
ing environments in single- or multi¬ 
user configurations.Price: $595 and 
up, 

Raima Object Manager 3.0 is a class 
library that allows use of Velocis 
Database Server and Raima Database 


Manager as an OODBMS, ROM 
encapsulates object storage and data¬ 
base navigation into C++ class defini¬ 
tions to provide a consistent object- 
oriented interface to Raima databases. 
The library adds persistence to any 
C++ object, object identity, class or 
type hierarchies, container classes, 
safe type checking, VLT, BLOB, 
Referential Integrity, server exten¬ 
sions, and so on. Price: $495 and up, 

Raima Corp., 1605 NW Sam¬ 
mamish Rd., Ste. 200, Issaquah, Wash, 
98027, (206) 557-0200, fax (206) 557- 
5200. 

RHINTEK COMPUTER 
ENGINEERING INC. Circle No. 164 

Rhino Com 15 is developed for OS/2's 
Presentation Manager. It is a general 
purpose, industrial strength commu¬ 
nications package emphasizing relia¬ 
bility, versatility, and ease-of-use, 
RhinoCom is multithreaded, can han¬ 
dle multisessions, and contains multi- 
media sounds. This product also fea¬ 
tures advanced workplace Shell 
technology, REXX scripting, and 
macro capabilities. Price: $199. 

Rhintek Computer Engineering 
Inc., 8835-C Columbia 100 Pkwy., 
Columbia, Md. 21045, (410) 730-2575, 
fax (410) 730-5960. 

SUNDIAL 

SYSTEMS CORP. Circle No. 165 

Relish 2.2, time management software 
for workgroups and individuals, con¬ 
tains calendars, to dos, and a phone 
book that is integrated for reliability. 
In addition, this product includes 
desktop objects for common and cus¬ 
tomizable views, keyword searching, 
and drag-and-drop convenience. 
Relish runs on the PowerPC and 
mixed Intel-PowerPC environments. 
Price: contact vendor. 

Sundial Systems Corp., 909 
Electric Ave., Ste. 204, Seal Beach, 
Calif. 90740, (310) 596-5121, fax (310) 
598-9851. 

SPG INC. Circle No. 166 

CoIorWorks for OS/2 PowerPC 1.0 is a 32- 

bit multitasking, multithreaded graph¬ 
ics paint image-processing, and 
image-editing software. CoIorWorks 
eliminates the hourglass cursor, can 
save up to 90% of the memory usually 
needed to edit images, and can spread 
work across up to 64 processors-for 
workstation performance and beyond 
on a PC. Price: contact vendor. 

SPG Inc,, 155505 Bull Run Rd., 
Ste. 303, Miami Lakes, Fla. 33014, (305) 
823-6602, fax (305) 823-2753. 
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The staff of OS/2 Developer put together this special section to guide you through the various software 
tools specifically for database development. The products described in this guide are based on surveys 
sent to vendors; they are provided as a service to you and are free to vendors. These listings do not 
represent an endorsement by OS/2 Developer. Although every effort has been made to ensure accuracy, 
we do not assume any responsibility for error or omission in this section. 



Database Development Tools 
Buyers Guide 


ACUCOBOL INC, Circle No. 101 

Acu4GL provides seamless access to Informix, 
Oracle, and Sybase databases from new or 
existing applications written in AcuCOBOL- 
85 by generating SQL queries. With Acu4GL, 
users can benefit from RDBMS technology 
without learning SQL, rewriting applica¬ 
tions, or retraining. Applications need to be 
compiled only once. This product eliminates 
the need to add embedded SQL to existing 
COBOL programs. Instead, industry-stan¬ 
dard COBOL I/O verbs generate SQL to 
access the database. This bidirectional infor¬ 
mation exchange allows users to utilize 
fourth generation report writers and query 
tools while retaining the use of their COBOL 
application. Price: contact vendor, 

AcucobohSS is a portable COBOL com¬ 
piler for microcomputers, minicomputers, 
and mainframes available. It produces com¬ 
pact , yet optimized machine-independent 
object code and runs on over 600 different 
platforms without recompiling, Acucobol-85 
is source code compatible with RM/COBOL, 
VAX COBOL and DG-ICOBOL and includes 
its own user-replaceable file system. Price: 
contact vendor, 

Acucobol Inc, 7950 Silver ton Ave., Ste. 
201, San Diego, Calif, 92426-6344, (619) 689- 
7220 or (800) COBOL85, fax (617) 566-307L 

APICAL SOFTWARE INC Circle No, 102 

GpfRexx 1.0 is an OS/2 PM visual develop¬ 
ment tool that makes possible the use of 
REXX for implementation of custom logic. It 
is suitable for individuals and professional 
programmers, and offers all the power nec¬ 
essary to create full-functioned applications 
and/or working prototypes. There are no 


royalties on GpfRexx generated applications. 
Its design files are compatible with Gpf 2,1, 
permitting designs or prototypes to be 
ported to C/C++ without having to recreate 
the GUI, GUI management logic, or Help. 
Price: $199. 

Gpf 2.1, is a visual GUI design environ¬ 
ment that is not industry specific, which 
offers full support for OS/2 2,x and OS/2 
1.3x, a CUA'91 compliant GUI, and Gpf gen¬ 
erates C or C++ source as well as Help 
source and all ancillary files to build the 
design. Gpf automatically generates all the 
logic to manage the entire user interface, 
leaving the designer free to concentrate on 
custom application logic. Price: $1,295. 

Apical Software Inc., 40 Falls Rd., P.O. 
Box 432, Moodus, Conn, 06469-0432, (203) 
873-3300, fax (203) 873-3302. 

BACHMAN INFGRMA TfON 
SYSTEMS INC. Circle No. 103 

Bachman/Analyst 4.2 is a comprehensive and 
scalable business-modeling solution for 
today's application development organiza¬ 
tions. It supports a range of platform-in de¬ 
pendent modeling tasks, ranging from high- 
level business data and process modeling 
through detailed application modeling. The 
Bachman/Analyst enables companies to 
build flexible, in-depth models that accu¬ 
rately reflect business requirements and 
become long-term reusable assets for the 
organization as it grows and changes. Price: 
$10,000 per seat, 

Bachman/DBA for DB2 4.2 provides a 
graphical interface for rapid database design, 
describes database contents completely, and 
is fully integrated with tools for DB2 data- 
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base design. This product helps design 
and implement databases for a variety 
of other relational databases including 
Sybase and Microsoft SQL Server, 
Oracle, Informix, Ingres, Rdb, IBM's 
DB2/2, and OS/2 Extended Services 
Database Manager. Price: $15,000. 

Bachman Information Systems, 8 
New England Executive Fk., Bur¬ 
lington, Mass, 01803, (617) 273-9003, 
fax (617)229-9904. 


BRIGHTWARE INC. Circle No. tQ4 

ART*Enterprise for OS/2 1.0 R1 is a tool 
for building intelligent software appli¬ 
cations that integrate databases, docu¬ 
ments, and business policies. It pro¬ 
vides business object modeling, 
business rules that automate corporate 
policies, and case-based retrieval 
(CBR) technology, which permits nat¬ 
ural language retrieval of objects. A 
supported DBMS includes DB/2, 
Oracle, Sybase, SQL Server, and others 
via Q+E. ART*Enterprise applications 
are fully portable across Windows, 
OS/2, and Unix. Price: $7,995. 

Brightware Inc., 101 Rowland 
Wy., Ste. 310, Novato, Calif. 94945, 
(800) 532-2890, (415) 899-9070, fax (415) 
899-9080. 


CONSYSTSQL 

DESIGN INCCircle No. 105 
SQL Design 2.1 is a rapid client/server 
application development generator for 
SQL databases, and it offers database- 
independent cross-platform solutions. 
This 4GL tool uses a graphical user 
interface to create powerful, user- 
friendly programs cost-effectively. An 
efficient productivity tool for the 
development and maintenance of 
applications, SQL Design enables pro¬ 
grammers to generate systems easily 
and in less time. Price: $250. 

Consyst SQL Inc., 15 Mont-Royal 
W., Ste. 120, Montreal, Que, Canada. 
H2T 2R9, (514) 849-7431, fax (514) 849- 
8125. 


DSOFT 

DEVELOPMENT INC. Circle No. 106 

dbfUB Programmer's Library 2.04 is a 

C/C++ programmer's library for 
accessing dBASE data files and 
indexes. Included are royalty-free 
DLLs for Windows, Windows NT, and 
OS/2. Additional support for DOS is 
also included. dbfLIB provides a con¬ 
sistent set of APIs across DOS, 
Windows, NT, and OS/2 platforms. 


This allows development of applica¬ 
tions that can share dBASE programs 
currently in use, in addition to other 
programs that use dBASE files. This 
can all be done without migrating 
megabytes of dBASE files to another 
database environment. Price: $195. 

dbfREXX for OS/2 2.04 provides 
dBASE file access from your OS/2 
REXX programs. Works with inter¬ 
preted REXX or many of the popular 
REXX compilers, dbfREXX provides 
simple, affordable database manage¬ 
ment to your REXX programs. As a 
migration tool, many corporate devel¬ 
opers use dbfREXX to move data from 
the mainframe to the PC environment 
for use as dBASE files. Price: $99. 

dSOFT Development Inc., 4710 
Innsbruck Dr., Houston, Tex. 77066, 
phone/fax: (713) 537-0318 

HILBERT COMPUTING Circle No. 107 

Cbron 4.0 is a 32-bit multithreaded PM 
application that will schedule OS/2, 
DOS, or Windows programs running 
under OS/2 at a selected time at 
selected intervals. Chron uses REXX as 
a macro language to extended the base 
scheduling options. Price: $99. 

Hilbert Computing, 1022 N. 
Cooper Ct., Olathe, Kans. 66061, (913) 
780-5051, fax (913) 829-2450, 

INTELLIGENT 

OBJECTS CORP. Circle No. 108 

SQL Objects 2.2 will supply cross-plat¬ 
form, multi-database development 
tools. Encapsulated are all of the popu¬ 
lar databases into a C++ class library. 
SQL Objects supplies drivers for 
Oracle, Sybase, SQL Server, SQL 
Sybase, Watcom SQL, Informix, 
DB2/6000, DB2/2, DDCS/2, Netware 
SQL, Btrieve, and so on. Cross-plat¬ 
form development is possible. Price: 
$699. 

Intelligent Objects Corp., 47 
Stonewall St., Cartersville, Calif. 30120, 
(404) 382-6585, fax (404) 382-6374. 

MACHINE INDEPENDENT 
SOFTWARE CORP. Circle No. 10$ 

CQL++ 8.0 provides a single user or 
client/server SQL database engine 
including complete C++ source code. 
CQL++ is usable in any environment 
where a C++ compiler is available 
meeting the proposed ANSI C++ spec¬ 
ification (templates not required). 
CQL++ implements ANSI SQL 1989 
with ODBC extensions and provides 


an embedded interface as well as an 
ODBC driver. Price: $495 for a single- 
user, $995 for client/server. 

Machine Independent Software 
Corp., 1819 Ridgemont, Columbia, Mo. 
65203, (800) 823-8672, (314) 446-4242, 
fax (314) 446-4243. 

MERCURY 

INTERACTIVE Circle No. 110 

WinRunner for OS/2 3.5 provides prod uc- 
tive solutions for automated testing of 
GUI client applications. It tests the 
application automatically with speed, 
accuracy, and repeatability, thereby 
greatly reducing testing time. Price: 
$4,995^ 

Mercury Interactive, 470 PotTero 
Ave., Sunnyvale, Calif. 94086, (408) 
523-9273, (408) 523-9911. 

OBJECT DESIGN INC. Circle No 111 
ObjoctStore 4.0 is a high-performance 
database for storing complex data 
structures and nonrecord-oriented 
information in heterogeneous client/ 
server environments. QbjectStore fea¬ 
tures distribution and transaction 
management for concurrent access to 
objects among members of a work¬ 
group, It also offers state-of-the-art 
database functions such as data 
integrity, version control, query pro¬ 
cessing, and a complete multi¬ 
client /multi-server architecture. Price: 
contact vendor. 

Object Design Inc., 25 Mall Rd., 
Burlington, Mass. 01803, (617) 674- 
5162, fax (617) 674-5262. 

ON-LINE DATA Circle No. 112 

OnCmd xBase for OS/2 1.1.5 harnesses the 
power and the speed of OS/2, 
enabling you to develop new or 
migrate existing applications from 
dBASE, FoxPro, or Clipper to native 
32-bit GUI application environments. 
It comes with screen painter, report 
writer, DLL/DDE support, 350+ func¬ 
tions/commands, and is client/server 
ready. Unlimited run time and server 
add-on licensing is available. Price: 
$249. 

On-Line Data, 5 Hill St., 
Kitchener, Ont, Canada. N263X4, (519) 
579-3930, fax (519) 579-2130. 

PARCPLACE 

S YSTEMS INC Circle No. 113 

VisualWorks 2.0 is a powerful client and 
server tool for building portable appli¬ 
cations using object-oriented techno 1- 
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ogy. A Database Application Creator is 
included for rapid application devel¬ 
opment, Applications developed are 
instantly portable across the enterprise 
and can have their functionality dis¬ 
tributed between both client and 
servers. Price: $2,995. 

VisualWorks Report Writer , an 
extension to the Visual Works product 
line, is a comprehensive query and 
report-generation tool for VisualWorks 
developers and users. Fully integrated 
with VisualWorks, this client/server 
development tool builds portable 
applications with object-oriented tech¬ 
nology and provides point-and-dick 
access to a number of reporting capa¬ 
bilities, With its spreadsheet-like 
macro language, ReportWriter is intu¬ 
itive enough for users, yet powerful 
enough for programmers. Price: $375, 

ParcFlace Systems, Inc,, 999 East 
Arques Ave., Sunnyvale, Calif, 94086- 
4593, (800) 759-7272, (408) 481-9090, 
fax (408) 481-9095. 

POET SOFTWARE CORP Circle No. 114 
POET 3.0 is a C++ Object DBMS that 
supports encapsulation, inheritance, 
and polymorphism. It is available for 
14 different operating systems and 
comes as single-user or client/server 
version. POET 3.0 features include 
OLE and ODBC support, schema ver¬ 
sioning, check-in/check-out, online 
backup, as well as a developer work¬ 
bench that includes class and object 
browsers. Price: contact vendor. 

POET Software Corp., 999 Baker 
Wy., Ste, 100, San Mateo, Calif. 94404, 
(415) 286-4640, fax (415) 286-4630. 

PROGRAM ART CORP. Circle No. 115 

APMpower Application Performance 
Analysis System is used to analyze MVS 
application performance data. 
Operating with Programart's STROBE 
Application Performance Mea¬ 
surement System, APMpower enables 
developers to interactively manage 
measurement sessions of MVS applica¬ 
tions and to analyze their results using 
OS/2 workstations. Analytical aids, 
including application performance 
hints, online help, a database of mod¬ 
ule descriptions, and guided analysis 
methods empower developers, as well 
as technical staff to resolve application 
performance issues. The SQL analysis 
feature helps pinpoint SQL inefficien¬ 
cies by suggesting specific database 
definition and coding changes that 


could improve the performance of 
DB2 applications. Price: contact ven¬ 
dor. 

Programart Corp., 124 Mt. 
Auburn St., Cambridge, Mass. 02138, 
(617) 661-3020, fax (617) 498-4010. 

SAS INSTITUTE INC Circle No. 116 
SAS System 6.0 is an integrated suite of 
information delivery software for 
business decision making. It provides 
organizations with tools to access, 
manage, analyze, and present data 
within an applications development 
environment. Capabilities include EIS, 
data warehousing, client/server com¬ 
puting, database access, applications 
development, graphics, data analysis, 
report writing, quality improvement, 
project management, computer perfor¬ 
mance evaluation, and decision sup¬ 
port. Price: $985. 

SAS Institute Inc., SAS Campus 
Dr., Cary, N.C 27513, (919) 677-8000, 
fax (919) 677-8123. 

SOFTWARE AG Circle No. 117 

Natural 2.1.3.4 is a cross-platform 
fourth-generation language with the 
ability to support text-based or GUI 
development. Price: $90O-$1,495. 

Software AG, 11190 Sunrise 
Valley Dr., Reston, Va. 22190, (703) 
391-6981, fax (703) 391-8290. 

XDB SYSTEMS INC. Circle No. 118 

XDB Workbench 4.0 enables mainframe 
DB2 development and maintenance to 
be off loaded to less-costly, more pro¬ 
ductive platforms such as PCs and 
LANs. Providing programmers with a 
DB2 equivalent environment to 
develop, test, and execute complete 
DB2 application on a desktop, XDB 
Workbench consists of a fully DB2 
compatible database engine, a COBOL 
or PL/1 precompiler, and a suite of 
development and administrative tools. 
Price: $1,500, 

XDB Server 4.0 is a fully DB2 com¬ 
patible database system that brings 
the power mainframe database sys¬ 
tems to client/server platforms. XDB 
Server can be used as a repository for 
host-targeted development and as a 
production platform for running DSS 
or OLTP applications. XDB Server is 
currently available for OS/2. Price: 
contact vendor. 

XDB Systems Inc., 9861 Broken 
Land Parkway, Columbia, Md. 21046, 
(410) 312-9300, fax (410) 312-9505, 
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TCP/IP for OS/2® 

Our customers say our tcp/ip 
is the best because 
it’s faster, more complete, 
and reliable. 

Find out for yourself! 

... .... 

Supported: all released versions of OS/2 
including 32bit API for 2.x and above; 
SLIP and/or PPP on COM1 and/or COM2; 
Ethernet; Token Ring; ARCNet; NDIS and ODI 


Essex Systems, Inc. 

One Central Street, Middleton, MA 01949 
A Dan Lanciani Product 

TCP/2 is a Trademark of DLD consulting. All other products and trademarks arc the property of 
their owners. TCP/2 is Based in part on work done by the University of California Berkeley. 
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FAX Developer Tools 


Opt-Tech Sort/Merge 

High. Performance Sort/Merge/Select Utility 

Use as a stand-alone utility or call as a Subroutine. Many 
features including unlimited file size, multiple keys, record 
selection, duplicate elimination, summing and more! 

Call for free brochure Opt-TechData Processing 
P.O. Box 678 

Available for: Zephyr Cove, NV 89448 

OS/2 or Unix $249 Phone (702) 588-3737 
DOS or Windows $149 Fax (702) 588-7576 


From the developers of FaxWorks for OS/2 

Client/Server API and Printer Driver Toolkits 
Support for LANs, up to 96 lines per CPU, 
and all popular fax hardware 

Keller Group Inc. 


Voice: (612) 429-7273 Fax: (800) 329-3293 

Email: kgroup@ibm.net Fax: (612) 653-1987 

Faxworks Is a trademark of Global Village Communication 


The easiest to use, most powerful 32 bit OS/2 PM 1PF Language Editor .. 


New! IPF Editor 2.0 

• Designed for intuitive use by anyone 

• Supports all IPF Tags, with simple index creation, easy 
multiple-window creation, and drag-and-drop panel ordering 

• Generate C program and Resource source 
to add help to applications in minutes 

• Import WordPerfect, Describe and RTF 

• Preview IPF output without compiling 

• Create all hypertext links automatically 

• Sound Support and Spell Check 

• Complete on-line help and documentation 

• Optional multi-user nework version 


SRP: 
$1951 


Orders: 
1-800-IPF-7622t 

Information: (360)428-5025 1 
on CompuServe at 
70410,2416 


Perez Computing Services I 
4725 Monte Vista Place 
Mt Vernon, WA 98273 


JOB SCHEDUUN6 SERVER 


OS/2 PM 32-bit advanced job scheduler for NOVELL 
and IBM LANs. Schedules multiple OS/2, DOS, and 
Windows jobs for concurrent execution on specified or 
auto selected LAN nodes. Conditional job scheduling 
(depends on files and other jobs return codes), security, 
sophisticated calendar, job logging, priority, user APIs, 
job recovery, periodic scheduling, and much more. 
Microwork, Inc. 

Phone: (708) 940-8979 Fax: (708) 940-8979 
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The dBase Database Access For REXX 

° Works with DBF. DBT. NDX and MDX files, 
o Supports dBase III and IV file formats, 
o Uses standard REXX API function calls, 
o Comes with a GUI Front-End for Database Maintenance. 

Find tte shareware version RXBASZQ3J3P m your f avorite BBS, 

Use it with VisPro/Rexx,VX Rexx and GpfRexx 

American Coders, Ltd. Post Office Box 97462 Raleigh, NC USA 27624 
(919) 846-2014 

Internet: joe6usacoder.rtp.nc.us CIS: 74150,2370 
Only $95.00 + shipping & handling 


Send text messages to pagers 
directly from OS/2! 


1 Easy-to-use workplace shell application 
k • Includes a command line interface 
► You can 'page-enable* your applications!] 
• 32-bit, SOM-based code - Onl\ $79 


ChipChat® Wireless Communicator 

ChipChat-Cawthon Software 
Dearborn, Michigan USA & Fukuoka Japan 

Phone 313-565-4000 Fax 313-565-4001 
























Jagre SmartLink 


1 L 


Network Remote Control And Monitoring 

Help Desks Automated Ag ent M onitoring 

PM/Pirate 

Named Pipes 
TCP/IP 

Lowest network toad 
Record and Playback 
All PM Video Modes 
No Special Drivers 

FAST! 

Automated Cycling 

$ 89 . 00 + 


Digital C6rririiuiMatfk>r}& Solutions 

aflSD btorth Team* Cl. m Suit* 7 
Ctdir RtpUi. 1A 5J402 

Softel also provides: 

In >nd Outbound cell comer application* - 

infoffn&ttQfi tytitfiB 
Prgdi&jvt (faJtng 

Internal Service provider end Client Software. 
Presentation Mane gar Development and Consulting I 

(800) 701-7205 
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TRACK 'em DOWN! 


Track: Customize: 

* Bugs, Change Requests e Reports 

* Projects, Code Changes • Queries 

* Customer Calls and more * Forms & fields 
Automatic Notification: Nothing Tails through the cracks 
integration with Version Control: Link files to bugs & bugs to files 
Multiple Linked Databases: Track bugs, customers and more 
industry Standard Databases: Access from other applications 

SOFFRONT FREE working DEMO! 

Software Inc. 1-800-763-3766 / 408.263.2703 

238 S. Hillview Drive. Milpitas, CA 95035 Fax: 408.263.7452 
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Jagre SmartLink and Lotus Notes: 
A Winning Combination! 


In today's computer world, communicating effectively and quickly could 
be the difference between your company being a dead company or being a I 
quick company. 

Using Lotus Notes within your company, gives your company the ammu- | 
nition it needs to be a quick company. 

Now. Jagre, Inc. provides your company with the competitive advantage 
to being — and slaying — a quick company: Jag re $mar|LinL 

Jagre SmartLink is a set of Lotus Notes-enabled tools grouped together 
in one place to empower your IBM OS/2-based desktop applications to 
com enunciate effectively and quickly with Lotus Notes for Document 
Management. E-mail, Fax, Pager, OCR, Voice, Video, and User-based 
Agents to gets tasks done quickly. 


I With Jagre SmartLink, the powerful features of Lotus Notes are now a button 
click away! 



IPs easy 
to integrate 
business graphics 
into your 
OS/2 PM * 
or 

Windows 3.x* 
application 


Developer's Business Graphics Toolkit 


• High-level APIs 

• Tactile feedback 

• Real-time charting 

• 16-bit and 32-bit 


• Dynamic Link Library 

• Positive/negative data 

• Printer/metafile support 

• 25+ chart types 



oducwfy... 

oU OS/2 DEVELOPER 

'products and Serviced (fade 

Each i ssue of OS/2 Developer will now feature this 
special advertising section. 

Casts for an 1/8 page ad rangefrom $350-$450 
Casts for a 1/4 page ad rangefram $600-5900 

tfaM JW tetiU: 

Krietin Morgan 
212-626-2498 


Advance at the speed of light. 

DESIGNERS * DEVELOPERS • ARCHITECTS 

Since 1979 Spectrum Concepts Ins enabled its clients to 
effectively meet their business objectives by providing leading- 
edge information technology consulting expertise. The contin¬ 
ued success of our rapidly expanding and highly skilled 
consulting team has created new opportunities for talented 
professionals with the following skills: 

• OS/I GUI * C++, OOD/OOP 



Conlal Karin lauKferen (212) 791+000x250 Fax (212) 791+639 
CtKipEerve: 746743571 Internet spectnirn^pipdiite.ooiri and/or rial ieutk id: 
Spectrum Concepts lW Broadway, Suite 600. Dept Q$2, NY, NY 10038 


HSTLUXD 

H c a n c * p t s 
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New Products for OS/2 


C- Vision 4M. This set of tools allows programmers to 
analyze, understand, document, and maintain C and 
C++ source code. The package consists of four main 
components: a cross-referencer, a diagrammer for 
function-call graphs and class hierarchies, a source 
code reformatter, and an intelligent source code lister. 
The cross-referencer produces a listing of symbols 
enhanced with usage and type information, while the 
tree diagrammer provides numerous output formats 
for different views of your code. The C-Vision refor¬ 
matter provides for flexible indentation control, 
including independent positioning of curly braces, 
nested preprocessor statements, case/default state¬ 
ments, and labels. 

Gimpel Software Circle No.180 

Phone: (610) 584-4261, Fax: (610) 584-4266 

CAPWatch f.fl Creative Assistance Software announces 
the release of CapWatch 1.0, a new addition to its line 
of OS/2 LAN Server utilities. CapWatch is designed to 
meet the need of LAN Server administrators, particu¬ 
larly those using LAN Server Entry to track server uti¬ 
lization against configured capacity parameters. In 
addition, this product provides real-time graphing of 
the utilization, logging of the data, graph capture, and 
re-display and configurable alarm and alert levels. The 
program may be operated locally on the server being 
monitored without generating network traffic, or 
remotely across the LAN from any OS/2 workstation. 

Creative Assistance Software Circle No. 181 

Phone: (704) 544-0001, Fax: (704) 543-6366 

Bridgeware, The Bridgeware family of products is the 
first suite of development and run time tools to pro¬ 
vide access from GUI fourth-generation languages, 
such as Powerbuilder and VisualBasic, to Micro Focus 
COBOL, and CICS applications. This product gener¬ 
ates a complete interface from 4GL applications to 
COBOL with no manual coding, rewriting, or retesting 
required. It extends 4GL client/server applications 
with true multitasking, server-based business logic for 
development and deployment on a wide range of 
environments. The Bridgeware family of products 
includes Micro Focus DeskTop Bridgeware and the 


Micro Focus Bridgeware Server Enabling Kit, both 
suited for rehosting and partitioning COBOL and 
CICS applications for reuse within a client/server 
architecture. 

Micro Focus Circle No. 182 

Phone: (415) 856-4161, Fax: (415) 856-6134 

Gui-Kit f. 1 . This cross-platform GUI toolkit for C and 
C++ simplifies the development of GUI-based applica¬ 
tions. Gui-Kit provides an intuitive object-oriented 
programming environment for C or C++. 

Visual Systems Corp. Circle No. 183 

Phone: (612) 434-6382, Fax: (612) 434-6538 

UnkWiz . This product makes file transfers fast with 
graphical interfaces that operate under OS/2 2.1, OS/2 
Warp, and OS/2 Warp Connect, Operating across plat¬ 
forms and in multiple environments, LinkWiz trans¬ 
fers files from one computer to another. The utility 
software also features file and disk management capa¬ 
bilities and provides high-speed data-transfer with 
build-in error correction, moving up to 8 MB a minute 
over special parallel and serial cables that come with 
the software. 

PCX Circle No. 184 

Phone: (619) 481-6300, Fax: (619) 481-6474 

OQMetric 2.0. This object-oriented metrics tool now cal¬ 
culates and reports on over two dozen object-oriented 
metrics for class, size, class inheritance, class internals, 
project concerns, method size, method internals, and 
method externals. Both project and design metrics are 
evaluated. Design metrics cover all aspects of both the 
quality of the object model and the most efficient 
implementation of its architecture. Project metrics han¬ 
dles administrative concerns, estimating and reporting 
on scheduling and staffing during the development 
process. OOMetric is a standalone program with 
probes for a variety of popular Smalltalk dialects. 

Hatteras Software Circle No. 185 

Phone: (919) 319-3816, Fax: (919) 319-3877 
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NC APPLICATIONS RUN ON: MS DOS (GRAPHICS ft TEXT) MS DQS/V (GRAPHICS & TEXT) NEC PC9800 (GRAPHICS & TEXT) MS WINDOWS 


A few words from our competitors: 

Prtablty. 

Prtbilty. 

Portblty. 

Portabit. 


PC. ' LABS 

ANAL YST’S 

'JTChoice 

~ ' JAM JA IMS 

INFO WORLD 

febnufr b. 1995 


“Deve/cpere scelting cosy delivery of 
GUI appftcfltrons on DOS. Whndmus, 

OS/2, Moomoift and Uni* platforms. at 
pyrsying <nre//iotF«iQl .iw^efs wfJ frnd 
ZmC [ft #tr ft#S[ dp[ior> by far ‘ 

‘Zm<r cam# c/aint of ait tfce produces w# 
t?st#d co out ideal o|T■ /usi dopy 
tft# cad* Co the target machine, then 
fccompfj'# <jnd relink eft# opplteatian In 
iftorc. Ztae did a great jab.‘ 


No matter how they misspell it, it s still not 
portability. At Zinc, we understand that porting 
the last 20 % of your code takes 80^ of your time. 

Only Zinc offers complete portability. 

With Zinc* Application Framework you can 
develop on the platform you prefer. And since 
Zinc is the only one that delivers I 00 % portability, 
you'll have your application on other platforms as 
fast as you can recompile, It's part of what makes 
Zinc the most productive—and affordable—tool a 
programmer can use. 

Productivity that leads to opportunity. 

Portability is just one road you'll find a little 
easier. Zinc zips through tedious tasks with O ■ 
object orientation and a unique visual develop¬ 
ment tool. Globalizing your application is as easy 
as translating the text. And Zinc is the only prod* 
uct that supplies 100 % of the source code. 

It all adds up to productivity. Which means 
more profitability. Which is a concept we proba¬ 
bly don't have to spell out for you. For free infor¬ 
mation and demonstration software, call toll-free: 

8 00 638 8665 

Outside the O.S. call; +1 801 785 8900. In Europe call: 

*44 (0)181 855 99(8, in Asia: *81 (052) 733 4301I. Contact Z«nc 
electronically at info@zinc.com or GO ZINC on CompuServe. 
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( W l N I E A WIN32S) MS WINDOWS NT 3 X (INTEL ft ALPHA) MS WINDOWS 9S ASIAN WINDOWS 3 ) ASIAN WINDOWS NT 3.X. ISM OS/2 (2 X ft 3 0 WARP). ASIAN OS/2 APPLE MACINTOSH (6BK 











The verdict is: One s y pleasure, 
hio are useful, and ones a pain. 

Scores run from 7.2 
to 2.7. from worthy 
to worthless . 
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Dr.Dnhh’s There's a 

saying that 
good design is invisible As Ward 
Cunningham puts it. 'Good class 
libraries whisper the design in your 
ear ” This is the case with zApp, 
which straightforwardly provides 
all the usual classes you d expect 
in building event-drawn GUI 
programs: a main application class, 
a small hierarchy of event handling 
classes, classes for graphic display, 
window-containing classes, and the 
usual GUI widgets (push buttons, 
check box . list box, and so on). 

There are no radical concepts or 
unpleasant surprises, greatly easing 
any learning curve associated with 
a brand-new APT 

Ray i hidts - October. tW2 


.EXE 


When presenting 
zApp with their 
Editor s Choice Award, Willie 
Watts explained why he "plumped 
for zApp V Of all the C+ + encap¬ 
sulations of Windows in all the bars 
in the world[ we both felt this was 
the best attempt we had seen, ami 
was something of a landmark in the 
use of this importan t language, 


mUKHAk Of 

OBJECT- ORJENIED 

The class design is the most impor¬ 
tant and most subjective aspect of 
a class library, and l think zApp s 
is superb. zApp encapsulates the 
entire underlying native APT 
In other words, if you want a 
Windows dialog, you get a Windows 
dialogue, not something that looks 
like one. 


Windows T f,T S u 

_^V_ Tech Award for 

C/C++, and 
Application Frameworks goes to 
tmnark Development Corp s zApp 
V. 2-0. zApp is simply the best 
designed application framework 
on the market. Its well-conceived 
classes make Windows programming 
an easier and more manageable 
process-and even fun. If C++ is 
your language of choice, then row 
should he using zApp. Period. 


Program now 


The doc¬ 
umentation 
provided with zApp is little short 
of superb. zApp 2 0 is a professional 
product which turns platform- 
independence into a practical 
proposition by its efficient, versatile 
and function-rich implementation. 


For genera f- 
purpose 

applications that area't limited to 
text, basic graphics, and dialog 
boxes, however, l suggest evaluating 
zApp first. Features like advanced 
graphics, printing support, ODE, 
compatibility with third-parly 
resource tools, and the ability to 
incorporate custom controls can 
be hanl to live without .. 

fofmttuJftum COM FL IT H SHOFPFK St<fi tV9t 
CopyrigfilG t9Sj ZigLkiwi i»*f (Wprfiiv 


Award winning developers 


i . x . ’ As long as you write 

i * i » ■ 

j! [J mm your applications 

iLI SLI.i ******* 2App °^ ectSt 

L'klfttfllfl can create 
programs for one compiler or 
environment and recompile them 
with another compiler for a different 
environment without any changes,.. 
zApp s object hierarchy remains the 
most comprehensive I ve yet seen 
in an application framework. 

fhfttrutitdftrtm "PC UaOAZJME" Zteei 22, IW’ 

1992 hfj lSsw. PubSakiiig fcuftpajU' 

£++REPORT 

Marketing people say things like 
“zApp is great, ft contains over 
200 classes. " That looks good in 
a slick and glossy brochure, but it 
leaves the fundamental question 
unanswered Are they goad classes? 
They are. zApps classes are well- 
implemented and easy to use, The 
library covers the fidl breadth of 
contemporary functionality and 
offers portability across most major 
operating systems. 


npmxu Mark 

ill If CUV Brittingham. 
a user-interface specialist with 
A T& T Bell Labs in Middletown, NJ, 
chose zApp over other frameworks. 
"You can see it s built by someone 
who builds applications. ” 
x*pri*i*tfom re ttEtx juiv w ms 

CapyripiiG f«J Ziff lSnu PuhtMuy Cmpiny 

II SOFTWARE mh!he 

Uevelopment 

• of a visual 

screen builder, the final burner to 
zApp productivity has fallen. For 
quick, form-based applications, 
zApp Factory makes C+ + produc¬ 
tive enough to be competitive with 
the interpreted languages. For more 
serious applications, the zApp 
framework is a superior application 
framework, f would use it even if 
I were just programming for 
Windows, but the fact that it 
compiles for Windows, Wtn/NT, 
OS/2, UNIX, and X/Mot if. is 
a nice little bonus. 


What l ve 
noticed 
about the 
company behind the product is that 
In mark's customer technical support 
is outstanding (usually a returned 
call within four hours), their BBS 
is full of great information, ami 
their attention to quotin' 



use Award winning tools. 




With the award winning zApp* Developer's Suite, you can quickly build state-of-the-art C++ applications 
that run across fourteen of today’s most popular operating systems. The zApp Developer’s Suite contains 
the latest in drag-and-drop design, prototyping and testing, code generation, and powerful GUI objects. 
Best of all this powerful technology sits on top of zApp, the industry leading application framework in 
use by tens of thousands of developers worldwide. For o free demo call: 1 -800-346-6275 
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rnmark Ui-vilnpment C urpnrattim 21)65 I .tiidinjis Drive, Mountain View. CA 94U4J {XOO) J4&-6Z7J,14fc5| 641-9IMX) Fax: 14 15) 641-4(1W 
In (he LLK.. and Scandinavia, call PTS/Software Plus at -44 (0) 92S 579400. tn France, call PTS/Siiftwjiri- Plus at (05) 90SW4, In Germany. call ESM Soft ware al 07702-9256-0, 

| n Italy, emit SfUtmi Valley Os-Unr at (044) tf 719*00, In Australia, call Micrn % ai (03) 5HIM333, BBS: 415*69I’9W0 - Internel: inftWtr tnroark ccm * CmnpaScnc GO TNMARK 
























